Délimiter le sujet
L’API dépend des identités, modèles de données et services sous-jacents.
Noter les exclusions et les hypothèses avec la même précision que les éléments inclus. Un périmètre limité peut être pertinent, à condition de ne pas présenter ses conclusions comme valables pour toute l’organisation.
Ne pas confondre authentification et autorisation. Vérifier les droits sur l’opération et sur l’objet demandé.
Application à votre contexte
Consignez les inclusions et les exclusions. Lorsqu'une activité dépend d'un partenaire ou d'un service transverse, documentez cette limite au lieu de supposer que la responsabilité s'arrête au contrat ou à l'organigramme.
Traitez le fonctionnement normal et les échecs comme deux parties du même produit. Décrivez les contrats d'interface, les erreurs, les reprises, les droits et l'observabilité. L'exploitabilité doit être prévue dès la conception, pas ajoutée après le premier incident.