Documentation développeurstableMis à jour 2026-07-08

Documentation développeur

Point d’entrée pour apprendre, intégrer, sécuriser et opérer Kadryn.

La documentation développeur Kadryn aide les équipes engineering et platform à connecter le trafic IA à Kadryn en sécurité.

Utilisez cette section pour authentifier les workloads côté serveur, router le trafic provider via Gateway, envoyer des événements d’usage directs, attacher des métadonnées, préserver les traces, configurer les webhooks et valider la préparation production.

Choisir votre chemin

Gateway

Utilisez Gateway lorsque Kadryn doit sit dans le runtime request path et appliquer policies avant exécution provider.

Start here: Gateway

Ingestion directe

Utilisez l’ingestion directe lorsque vous appelez déjà les providers directement et devez seulement envoyer l’usage normalisé à Kadryn.

Start here: Ingestion directe

Webhooks

Utilisez Webhooks lorsque vos systèmes doivent réagir aux événements Kadryn comme les rapports, alertes, exports ou changements de livraison.

Start here: Webhooks

Diagnostics

Utilisez Diagnostics lorsque vous devez understand why setup, delivery ou trafic visibilité est pas production-ready.

Start here: Diagnostics

Ordre d’implémentation recommandé

  1. Lisez la Vue d’ensemble.
  2. Configurez Authentification.
  3. Créez un Kadryn API clé.
  4. Ajoutez ou vérifiez Provider clés si vous utiliser Gateway.
  5. Choose Gateway ou Ingestion directe.
  6. Add consistent Métadonnées.
  7. Preserve Tracing.
  8. Utilisez Idempotence pour retry-sûr writes.
  9. Vérifiez requests dans Logs & Traces.
  10. Terminez avec la Checklist de production.

Principes de production

Une intégration Kadryn production doit :

  • keep Kadryn et provider secrets côté serveur;
  • identifier chaque workload avec des métadonnées project, feature et environment;
  • rendre les écritures retryables idempotentes;
  • préserver request IDs, trace IDs et request group IDs;
  • éviter logging secrets ou sensible payloads;
  • vérifier trafic dans Logs & Traces avant broad rollout;
  • utiliser Diagnostics lorsque readiness est degraded;
  • document ownership, rotation et incident réponse steps.

Developer surfaces

Clés API

Créez et faire tourner workspace API clés.

Ouvrir : Clés API

Gateway

Routez le trafic provider via Kadryn pour le contrôle runtime.

Ouvrir : Gateway

Ingestion directe

Envoyez des événements d’usage sans proxyfier les appels provider.

Ouvrir : Ingestion directe

Logs & Traces

Investigate requests, ingestion attempts, webhooks et diagnostics.

Ouvrir : Logs & Traces

Webhooks

Deliver Kadryn événements à vos systèmes.

Ouvrir : Webhooks

Diagnostics

Identify setup, trafic, provider, webhook et gouvernance issues.

Ouvrir : Diagnostics

SDKs

Utilisez starter examples et integration patterns.

Ouvrir : SDKs

Pages liées