Aller au contenu
KelkiDéveloppeurs

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èsdès l'ouverture du comptesur validation par Kelki, après acceptation des conditions
Référentiel et validationsréelsréels
Demandesgardées à part, jamais transmisescircuit normal de Kelki
E-mailsaucun (envoi simulé)e-mails réels à la personne
Statutsavancés par vous (simulate) ; abandon à 48 hréels
Webhooksréels, vers les adresses du mode testréels, vers les adresses du mode live
Agent Kelkiréel, plafond de messages basré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

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.