Bac à sable
Avec une clé kk_test_…, tout fonctionne comme en production — même référentiel, mêmes validations, mêmes erreurs, mêmes formes de réponse — mais aucune demande réelle n'est créée et aucun e-mail ne part.
Test et production
Bac à sable (kk_test_, kat_test_) | Production (kk_live_, kat_live_) | |
|---|---|---|
| Accès | dès l'ouverture du compte | sur validation par Kelki, après acceptation des conditions |
| Référentiel et validations | réels | réels |
| Demandes | gardées à part, jamais transmises | circuit normal de Kelki |
| E-mails | aucun (envoi simulé) | e-mails réels à la personne |
| Statuts | avancés par vous (simulate) ; abandon à 48 h | réels |
| Webhooks | réels, vers les adresses du mode test | réels, vers les adresses du mode live |
| Agent Kelki | réel, plafond de messages bas | réel |
Les deux modes sont étanches : une demande de test n'est jamais visible avec une clé live, et inversement (404).
Simuler les statuts
curl -s https://kelki.ai/api/v1/sandbox/requests/req_01JC00000000000000000000RQ/simulate \
-H "Authorization: Bearer $KELKI_KEY_TEST" -H "Content-Type: application/json" \
-d '{"status":"transmitted"}'
Valeurs possibles : transmitted, abandoned, sold, not_taken, called_back. Chaque changement déclenche les mêmes webhooks qu'en production. Avec une clé live, cette route n'existe pas.
Données factices
- Noms « Exemple », adresses en
example.com(domaine réservé, RFC 2606), numéros factices (+33639980042dans nos exemples). - Le bac à sable n'envoie jamais d'e-mail : une vraie adresse saisie par erreur ne reçoit rien. N'y mettez quand même que des données fictives.
Passer en production
Kelki ouvre l'accès réel après examen de votre service (description, écrans du parcours, contact d'un responsable) et acceptation des conditions de l'API. Vous créez alors une clé kk_live_… : votre code ne change pas. Le plan decouverte (bac à sable seul) n'autorise aucune demande réelle ; voir limites et quotas.