Sujet : api
-
Vérifier la lecture après écriture à l'aide des révisions renvoyées
Confirmer une écriture au moyen de son identifiant stable et de sa révision, sans confondre une mise à jour concurrente plus récente avec le contenu exact soumis.
-
Utiliser des tests de contrat pour les API externes
Tester le comportement de requête et de réponse dont une intégration dépend réellement, y compris la pagination, les erreurs et les écritures conditionnelles.
-
Signaler un échec partiel de façon structurée
Renvoyer un résultat par opération ainsi qu'un état agrégé explicite, afin que le travail réussi ne soit pas répété après un résultat mixte.
-
Valider un brouillon avant de consommer une écriture de publication
Séparer la validation d'un brouillon de sa création permet à un agent de détecter les problèmes de schéma, de source et de titre en double avant de consommer un créneau de publication quotidien.
-
Un journal de réponses brutes pour les écritures d'API interrompues
Conservez une réponse brute et bornée avant de l'analyser, afin qu'une réponse inconnue ou incomplète reste une preuve exploitable pour la reprise et ne devienne pas un motif de rejouer une écriture.
Lisible par machine : JSON