Développement local
Tester les intégrations Kadryn localement sans exposer de secrets ni polluer les coûts production.
Le développement local doit valider votre intégration sans exposer de secrets ni polluer les données de production.
Utilisez des environnements locaux ou de test, du trafic synthétique et des prompts sûrs.
Variables d’environnement
Utilisez un fichier .env local ignoré par Git.
KADRYN_API_KEY="kadryn_test_..."
KADRYN_API_BASE_URL="https://api.kadryn.com/v1"
KADRYN_GATEWAY_BASE_URL="https://gateway.kadryn.com/v1"
KADRYN_ENVIRONMENT="local"
N’utilisez pas de clés production en développement local sauf s’il n’y a aucune alternative et que le risque est compris.
Métadonnées pour le trafic local
Marquez toujours clairement le trafic local :
X-Kadryn-Environment: local
X-Kadryn-Project: local-dev
X-Kadryn-Feature: integration-test
Cela sépare les tests locaux des coûts et alertes de production.
Prompt de test sûr
Utilisez des prompts non sensibles.
Hello from local Kadryn integration test.
N’envoyez pas de données client, de secrets, de clés provider ou de prompts production pendant les tests.
Test local Gateway
curl "$KADRYN_GATEWAY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $KADRYN_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Kadryn-Project: local-dev" \
-H "X-Kadryn-Feature: integration-test" \
-H "X-Kadryn-Environment: local" \
-d '{
"model": "gpt-4.1-mini",
"messages": [
{
"role": "user",
"content": "Hello from local development"
}
]
}'
Test local ingestion directe
curl "$KADRYN_API_BASE_URL/usage/events" \
-H "Authorization: Bearer $KADRYN_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: local-usage-test-001" \
-d '{
"timestamp": "2026-07-06T12:00:00.000Z",
"provider": "openai",
"model": "gpt-4.1-mini",
"inputTokens": 10,
"outputTokens": 5,
"costCents": "1",
"project": "local-dev",
"feature": "integration-test",
"environment": "local"
}'
Vérifier localement
Ouvrir :
Developers → Logs & Traces
Filtrez par :
- environnement
local; - projet
local-dev; - synthetic trafic;
- trace ID;
- request group ID.
Éviter de polluer la production
Ne laissez pas le trafic local déclencher :
- production caps;
- production alerts;
- finance rapports;
- executive dashboards;
- client unit economics.
Utilisez environnement filters et test projets.
Dépannage
La requête locale n’apparaît pas
Vérifiez la clé API, la base URL, les filtres d’environnement et si la requête a échoué avant d’atteindre Kadryn.
La requête locale apparaît comme production
Corrigez X-Kadryn-Environment ou le champ d’ingestion directe environment.
Secret commité accidentellement
Faites tourner la clé immédiatement et retirez-la de l’historique Git si nécessaire.