Dépannage•stable•Mis à jour 2026-07-08

Erreurs Gateway

Diagnostiquer et corriger erreurs gateway.

Utilisez cette page lorsque le symptôme correspond à ce que vous voyez dans Kadryn ou dans vos logs d’intégration.

Symptômes

  • Gateway requests fail ou return non-success réponses.
  • Logs show authentication, policy, provider ou rate-limit échecs.

Causes les plus fréquentes

  • Invalid Kadryn API clé.
  • Missing provider clé.
  • Une policy ou un cap a bloqué la requête.
  • Provider rejeté le request.
  • Retry behavior est unsûr ou too aggressive.

Correction

  1. Vérifiez le API clé prefix et workspace.
  2. Ouvrez Developers → Gateway et passer en revue route readiness.
  3. Ouvrez Logs & Traces et inspecter le decision.
  4. Corrigez les clés provider ou les métadonnées de policy.
  5. Retry seulement lorsque le erreur class est retryable.

Vérifier la correction

  • Re-run le petitest sûr test.
  • Ouvrez Logs & Traces et search par request ID, trace ID ou resource ID.
  • Confirmez le relevant dashboard card updates après refresh.
  • Confirmez no retry loop ou doublon delivery un été créé.

Quand escalader

Escaladez lorsque le problème affecte le trafic production, un reporting sensible au billing, des preuves d’audit ou tout workflow où une feature IA exposée aux clients est bloquée.

Pages liées