# 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](mailto: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](https://kelki.ai/developers/fr/reference/catalog/#matchTrades)). ## 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](https://kelki.ai/developers/fr/consent/)). 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](https://kelki.ai/developers/fr/webhooks/)), 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](https://kelki.ai/developers/fr/examples/). ## Ensuite - Passage en production : sur validation par Kelki ; votre code ne change pas, seule la clé (`kk_live_…`) change ([bac à sable](https://kelki.ai/developers/fr/sandbox/)). - Erreurs et cas limites : [erreurs](https://kelki.ai/developers/fr/errors/), [limites](https://kelki.ai/developers/fr/rate-limits/), [idempotence](https://kelki.ai/developers/fr/idempotency/). ## Sur cette page - URL : https://kelki.ai/developers/fr/quickstart/ - Langue : fr - fr : https://kelki.ai/developers/fr/quickstart/ - en : https://kelki.ai/developers/en/quickstart/ - x-default : https://kelki.ai/developers/ - Portail : https://kelki.ai/developers/llms.txt