Aller au contenu
KelkiDéveloppeurs

Démarrage rapide

Six appels en bac à sable, de la clé de test au webhook. En mode test, aucune demande réelle n'est créée et aucun e-mail ne part.

1. Une clé de test

Le compte développeur donne une clé kk_test_…, montrée une seule fois. L'espace développeur en libre-service est en préparation : en attendant, demandez l'ouverture de votre compte à contact@kelki.ai. Gardez la clé côté serveur, dans une variable d'environnement :

export KELKI_KEY=kk_test_…

2. Le métier et ses listes

curl -s "https://kelki.ai/api/v1/trades/plombier?country=FR&lang=fr" \
  -H "Authorization: Bearer $KELKI_KEY"

La réponse donne services (liste fermée, dont « Autre besoin »), delays (libellés) et consent (version et texte d'accord). Si vous partez d'un besoin en mots courants, utilisez d'abord POST /trade-matches (référence).

3. Le lieu

curl -s "https://kelki.ai/api/v1/places?q=Cr%C3%A9teil&country=FR" \
  -H "Authorization: Bearer $KELKI_KEY"

Gardez l'id du lieu choisi, par exemple fr-creteil-94000.

4. Le brouillon

curl -s https://kelki.ai/api/v1/requests \
  -H "Authorization: Bearer $KELKI_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: resa-0042-draft-1" \
  -d '{"country":"FR","lang":"fr","trade_id":"plombier","service":"Recherche de fuite",
       "delay":"Dès que possible","place_id":"fr-creteil-94000",
       "contact":{"name":"Camille Exemple","phone":"+33639980042","email":"camille.exemple@example.com"},
       "reference":"resa-2026-0042"}'

Réponse 201 : status: "draft", recap et consent. Montrez le récapitulatif, puis le texte d'accord mot pour mot avec une case non cochée (règles). Le brouillon expire au bout de 2 heures.

5. La confirmation par e-mail

Après la case cochée par la personne :

curl -s https://kelki.ai/api/v1/requests/req_01JC00000000000000000000RQ/confirmation \
  -H "Authorization: Bearer $KELKI_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: resa-0042-confirmation-1" \
  -d '{"method":"email","consent_text_version":"v2026-10-18","consent_given":true}'

Statut awaiting_confirmation. En production, la personne reçoit l'e-mail « Confirmer ma demande » ; en bac à sable, l'envoi est simulé.

6. Le suivi

Déclarez une adresse de webhook (POST /webhook-endpoints, guide), puis faites avancer la demande de test :

curl -s https://kelki.ai/api/v1/sandbox/requests/req_01JC00000000000000000000RQ/simulate \
  -H "Authorization: Bearer $KELKI_KEY" -H "Content-Type: application/json" \
  -d '{"status":"sold"}'

Votre adresse reçoit l'événement request.status_changed, signé. Les mêmes appels en JavaScript et en Python : exemples de code.

Ensuite