Exploitation

Cette section rassemble ce qu'il faut pour exploiter une intégration sans surprise : ce que le serveur garantit quand quelque chose se passe mal, et ce qu'il vous revient de faire.

Ce que le serveur garantit

• Un refus de débit ne calcule rien et ne facture rien. Un 429 coûte moins cher qu'une requête servie. Voir Limites de débit.
• Une panne du moteur n'est jamais facturée ni mémorisée. Un 503 engine_error se reprend avec la même Idempotency-Key. Voir Reprises.
• Un règlement est atomique. La réservation de la clé d'idempotence, la facturation et la mémoire de la réponse sont écrites ensemble : il n'existe aucun instant où la facture serait enregistrée et la réponse perdue.
• Une tentative a exactement un identifiant, le même dans l'en-tête, le corps d'erreur et les journaux de Noryo. Voir Identifiants de requête.
• Aucune erreur ne laisse fuir d'information interne : ni SQLSTATE, ni nom de table, ni trace d'appel, ni nom d'hôte interne. Voir Erreurs.

Ce qui n'est pas publié

• Aucun engagement de latence ni de disponibilité n'est publié. Ne bâtissez pas vos délais sur une valeur supposée. Voir Délais d'attente.
• Les limites de débit de Production ne sont pas publiées : lisez Noryo-RateLimit-Limit.

La règle qui rend tout le reste sûr

Envoyez une Idempotency-Key générée une fois par opération, et réutilisez-la pour chaque reprise de cette opération. Avec elle, une reprise après un délai dépassé, un 500, un 503 ou une coupure réseau ne peut ni dupliquer un enrichissement ni le facturer deux fois. Ajoutez un external_transaction_id pour que la même transaction renvoyée des semaines plus tard soit reconnue. Voir Les deux identifiants.

Dans cette section

• Limites de débit : seau de jetons, en-têtes, 429 et Retry-After.
• Reprises : quoi reprendre, quand, et comment.
• Délais d'attente : ce qui se passe quand une requête dure, des deux côtés.
• Erreurs : le format Problem Details et le catalogue des codes.
• Identifiants de requête : Noryo-Request-Id, et comment s'en servir avec le support.
• Observabilité : ce que vous pouvez mesurer, et ce que Noryo journalise.