# API de l'Agent Kelki — portail développeurs (Kelki Agent API — developer portal) > Trouver le bon professionnel et lui transmettre une demande de rappel, avec l'accord explicite de la personne. > Find the right professional and pass on a call-back request to them, with the person's explicit consent. L'API est gratuite pour les partenaires. The API is free for partners. Adresse de l'API / API address : https://kelki.ai/api/v1 (version 1.0.0). Authentification par clé (`Authorization: Bearer kk_test_…` ou `kk_live_…`) ou jeton OAuth 2.0 (client credentials). ## Spécification / Specification - [OpenAPI (YAML)](https://kelki.ai/assets/developers/openapi.yaml) - [OpenAPI (JSON)](https://kelki.ai/assets/developers/openapi.json) ## Documentation (français) - [Intégrer l'Agent Kelki à votre application](https://kelki.ai/developers/fr/) : Intégrez l'Agent Kelki à votre application : trouver le bon métier, vérifier le lieu, préparer une demande de rappel, la faire confirmer par la personne, suivre son statut. API gratuite pour les partenaires. - [Démarrage rapide](https://kelki.ai/developers/fr/quickstart/) : Six appels en bac à sable, de la clé de test au webhook : métier, lieu, brouillon, confirmation par e-mail, statut simulé. Exemples curl, JavaScript et Python. - [Concepts](https://kelki.ai/developers/fr/concepts/) : Cycle de vie d'une demande, brouillon et accord de la personne, un seul professionnel, métiers locaux et nationaux, pays et langues, test et production. - [Authentification](https://kelki.ai/developers/fr/authentication/) : Clés API kk_test_ et kk_live_, jetons OAuth 2.0 client credentials, portées, rotation, révocation et bonnes pratiques de stockage. - [Consentement de la personne](https://kelki.ai/developers/fr/consent/) : Page à lire avant toute intégration : récapitulatif, texte d'accord v2026-10-18 mot pour mot, case non cochée, confirmation par e-mail de chaque demande, écrans conformes et non conformes. - [Bac à sable](https://kelki.ai/developers/fr/sandbox/) : Différences entre le bac à sable et la production, simulation des statuts, données factices : tout fonctionne comme en production, sans demande réelle ni e-mail. - [Guide : une conciergerie](https://kelki.ai/developers/fr/guides/conciergerie/) : Un bouton « Trouver un professionnel » dans une application de conciergerie : métier, lieu, brouillon, accord, confirmation par e-mail, suivi dans la réservation. - [Guide : intégrer l'Agent Kelki](https://kelki.ai/developers/fr/guides/agent/) : Confier la conversation à l'Agent Kelki : démarrer, envoyer texte, choix ou données, afficher le récapitulatif et le texte d'accord, recueillir l'accord, basculer vers le formulaire. - [Guide : formulaire sans agent](https://kelki.ai/developers/fr/guides/formulaire/) : Construire vos propres écrans avec les listes fermées de Kelki : métier, prestation ou « Autre besoin », délai, lieu, coordonnées, puis accord et confirmation. - [Guide : affiliation avec l'API](https://kelki.ai/developers/fr/guides/affiliation/) : Partenaires du programme d'affiliation : vos demandes créées avec l'API et l'Agent portent automatiquement votre code partenaire ; en-tête Kelki-Affiliate facultatif, suivi des commissions. - [Exemples de code](https://kelki.ai/developers/fr/examples/) : Exemples curl, JavaScript (Node 18+) et Python (bibliothèque standard) de l'API de l'Agent Kelki : métier, brouillon, confirmation, statut, vérification des webhooks. - [Guide des webhooks](https://kelki.ai/developers/fr/webhooks/) : Recevoir les changements de statut des demandes : déclaration de l'adresse, signature HMAC-SHA256, vérification, rejeu, nouveaux essais, ordre, désactivation. - [Référence de l'API](https://kelki.ai/developers/fr/reference/) : Référence de l'API de l'Agent Kelki : routes, paramètres, corps, réponses et schémas, générée depuis la spécification OpenAPI. - [Référentiel](https://kelki.ai/developers/fr/reference/catalog/) : Référence de l'API de l'Agent Kelki, section Référentiel : /countries, /trades, /trades/{trade_id}, /trades/{trade_id}/services, /trade-matches, /places, /consent-texts/{version}. - [Demandes](https://kelki.ai/developers/fr/reference/requests/) : Référence de l'API de l'Agent Kelki, section Demandes : /requests, /requests/{request_id}, /requests/{request_id}/confirmation, /requests/{request_id}/events, /sandbox/requests/{request_id}/simulate. - [Agent](https://kelki.ai/developers/fr/reference/agent/) : Référence de l'API de l'Agent Kelki, section Agent : /agent/conversations, /agent/conversations/{conversation_id}, /agent/conversations/{conversation_id}/messages. - [Webhooks (référence)](https://kelki.ai/developers/fr/reference/webhooks/) : Référence de l'API de l'Agent Kelki, section Webhooks (référence) : /webhook-endpoints, /webhook-endpoints/{endpoint_id}, /webhook-endpoints/{endpoint_id}/test, /webhook-endpoints/{endpoint_id}/rotate-secret. - [Compte](https://kelki.ai/developers/fr/reference/account/) : Référence de l'API de l'Agent Kelki, section Compte : /account, /account/usage. - [OAuth](https://kelki.ai/developers/fr/reference/oauth/) : Référence de l'API de l'Agent Kelki, section OAuth : /oauth/token, /oauth/revoke. - [Erreurs](https://kelki.ai/developers/fr/errors/) : Format RFC 9457 des erreurs de l'API de l'Agent Kelki, catalogue des codes stables et que faire pour chacun. - [Idempotence](https://kelki.ai/developers/fr/idempotency/) : L'en-tête Idempotency-Key de l'API de l'Agent Kelki : routes concernées, rejeu sous 24 heures, conflits, doublons de contenu. - [Pagination](https://kelki.ai/developers/fr/pagination/) : Pagination par curseur de l'API de l'Agent Kelki : limit, starting_after, next_cursor, en-tête Link et boucle d'exemple. - [Limites et quotas](https://kelki.ai/developers/fr/rate-limits/) : Plafonds techniques de l'API de l'Agent Kelki par plan (découverte, standard, partenaire), limites communes, en-têtes RateLimit et conduite à tenir sur 429. - [Versions](https://kelki.ai/developers/fr/versioning/) : Règles de version de l'API de l'Agent Kelki : version majeure dans l'adresse, ajouts seulement, dépréciation annoncée, en-têtes Deprecation et Sunset, 12 mois de recouvrement. - [Sécurité et données](https://kelki.ai/developers/fr/security/) : Rôles RGPD, minimisation, ce que le partenaire reçoit et ne reçoit jamais, durées de conservation, chiffrement des champs, isolement, journaux et incidents. - [API, MCP et A2A](https://kelki.ai/developers/fr/mcp/) : Correspondance entre l'API de l'Agent Kelki, le connecteur MCP pour les assistants IA et l'Agent Kelki : quand choisir l'un ou l'autre, règles communes. - [Journal des changements](https://kelki.ai/developers/fr/changelog/) : Changements datés de l'API de l'Agent Kelki : ajouts, corrections, dépréciations. - [Statut](https://kelki.ai/developers/fr/status/) : État de l'API de l'Agent Kelki et de ses services : page de statut status.kelki.ai, bientôt en ligne. - [Aide](https://kelki.ai/developers/fr/support/) : Questions fréquentes sur l'API de l'Agent Kelki, contact, informations à fournir, signaler un abus ou une faille. - [Conditions d'utilisation de l'API de l'Agent Kelki](https://kelki.ai/developers/fr/terms/) : Conditions d'utilisation de l'API de l'Agent Kelki pour les partenaires : accès gratuit, accord de la personne, confirmation par e-mail de chaque demande, plafonds, sécurité, responsabilité. - [Accord de traitement des données (article 28 du RGPD)](https://kelki.ai/developers/fr/terms/data-processing/) : Accord de traitement des données entre Kelki, responsable du traitement des demandes, et le partenaire de l'API, sous-traitant pour la collecte et l'envoi des demandes (article 28 du RGPD). - [Politique d'usage acceptable de l'API](https://kelki.ai/developers/fr/terms/acceptable-use/) : Ce qui est permis et interdit avec l'API de l'Agent Kelki : accord de la personne, confirmation par e-mail, exclusions, abus, sanctions. ## Documentation (English) - [Bring the Kelki Agent into your app](https://kelki.ai/developers/en/) : Bring the Kelki Agent into your app: find the right trade, check the place, prepare a call-back request, have the person confirm it, track its status. Free API for partners. - [Quickstart](https://kelki.ai/developers/en/quickstart/) : Six calls in the sandbox, from the test key to the webhook: trade, place, draft, e-mail confirmation, simulated status. curl, JavaScript and Python examples. - [Concepts](https://kelki.ai/developers/en/concepts/) : Request lifecycle, draft and the person's consent, a single professional, local and national trades, countries and languages, test and production. - [Authentication](https://kelki.ai/developers/en/authentication/) : kk_test_ and kk_live_ API keys, OAuth 2.0 client credentials tokens, scopes, rotation, revocation and storage best practices. - [Consent of the person](https://kelki.ai/developers/en/consent/) : Read before any integration: summary, consent text v2026-10-18 word for word, unticked box, e-mail confirmation of every request, compliant and non-compliant screens. - [Sandbox](https://kelki.ai/developers/en/sandbox/) : Differences between the sandbox and production, status simulation, dummy data: everything works as in production, without real requests or e-mails. - [Guide: a concierge app](https://kelki.ai/developers/en/guides/concierge/) : A “Find a professional” button in a concierge app: trade, place, draft, consent, e-mail confirmation, tracking in the booking. - [Guide: embed the Kelki Agent](https://kelki.ai/developers/en/guides/agent/) : Hand the conversation over to the Kelki Agent: start, send text, choices or data, display the summary and the consent text, collect consent, fall back to the form. - [Guide: form without the agent](https://kelki.ai/developers/en/guides/form/) : Build your own screens with Kelki's closed lists: trade, service or “other need”, timing, place, contact details, then consent and confirmation. - [Guide: affiliate program with the API](https://kelki.ai/developers/en/guides/affiliate/) : Affiliate partners: requests created with the API and the Agent automatically carry your partner code; optional Kelki-Affiliate header; commission tracking. - [Code examples](https://kelki.ai/developers/en/examples/) : curl, JavaScript (Node 18+) and Python (standard library) examples for the Kelki Agent API: trade, draft, confirmation, status, webhook verification. - [Webhooks guide](https://kelki.ai/developers/en/webhooks/) : Receive request status changes: declaring the endpoint, HMAC-SHA256 signature, verification, replay, retries, ordering, disabling. - [API reference](https://kelki.ai/developers/en/reference/) : Kelki Agent API reference: routes, parameters, bodies, responses and schemas, generated from the OpenAPI specification. - [Catalog](https://kelki.ai/developers/en/reference/catalog/) : Kelki Agent API reference, Catalog section: /countries, /trades, /trades/{trade_id}, /trades/{trade_id}/services, /trade-matches, /places, /consent-texts/{version}. - [Requests](https://kelki.ai/developers/en/reference/requests/) : Kelki Agent API reference, Requests section: /requests, /requests/{request_id}, /requests/{request_id}/confirmation, /requests/{request_id}/events, /sandbox/requests/{request_id}/simulate. - [Agent](https://kelki.ai/developers/en/reference/agent/) : Kelki Agent API reference, Agent section: /agent/conversations, /agent/conversations/{conversation_id}, /agent/conversations/{conversation_id}/messages. - [Webhooks (reference)](https://kelki.ai/developers/en/reference/webhooks/) : Kelki Agent API reference, Webhooks (reference) section: /webhook-endpoints, /webhook-endpoints/{endpoint_id}, /webhook-endpoints/{endpoint_id}/test, /webhook-endpoints/{endpoint_id}/rotate-secret. - [Account](https://kelki.ai/developers/en/reference/account/) : Kelki Agent API reference, Account section: /account, /account/usage. - [OAuth](https://kelki.ai/developers/en/reference/oauth/) : Kelki Agent API reference, OAuth section: /oauth/token, /oauth/revoke. - [Errors](https://kelki.ai/developers/en/errors/) : RFC 9457 error format of the Kelki Agent API, catalog of stable codes and what to do for each. - [Idempotency](https://kelki.ai/developers/en/idempotency/) : The Idempotency-Key header of the Kelki Agent API: routes concerned, replay within 24 hours, conflicts, content duplicates. - [Pagination](https://kelki.ai/developers/en/pagination/) : Cursor pagination of the Kelki Agent API: limit, starting_after, next_cursor, Link header and an example loop. - [Rate limits and quotas](https://kelki.ai/developers/en/rate-limits/) : Technical limits of the Kelki Agent API per plan (decouverte, standard, partenaire), shared limits, RateLimit headers and what to do on 429. - [Versioning](https://kelki.ai/developers/en/versioning/) : Versioning rules of the Kelki Agent API: major version in the address, additions only, announced deprecation, Deprecation and Sunset headers, 12-month overlap. - [Security and data](https://kelki.ai/developers/en/security/) : GDPR roles, minimisation, what the partner receives and never receives, retention periods, field encryption, isolation, logs and incidents. - [API, MCP and A2A](https://kelki.ai/developers/en/mcp/) : How the Kelki Agent API, the MCP connector for AI assistants and the Kelki Agent map to each other: when to choose which, shared rules. - [Changelog](https://kelki.ai/developers/en/changelog/) : Dated changes of the Kelki Agent API: additions, fixes, deprecations. - [Status](https://kelki.ai/developers/en/status/) : Status of the Kelki Agent API and its services: status page status.kelki.ai, coming soon. - [Support](https://kelki.ai/developers/en/support/) : Frequently asked questions about the Kelki Agent API, contact, information to provide, reporting abuse or a vulnerability. - [Kelki Agent API terms of use](https://kelki.ai/developers/en/terms/) : Terms of use of the Kelki Agent API for partners: free access, the person's consent, e-mail confirmation of every request, limits, security, liability. - [Data processing agreement (GDPR article 28)](https://kelki.ai/developers/en/terms/data-processing/) : Data processing agreement between Kelki, controller of the requests, and the API partner, processor for collecting and sending requests (GDPR article 28). - [API acceptable use policy](https://kelki.ai/developers/en/terms/acceptable-use/) : What is allowed and forbidden with the Kelki Agent API: the person's consent, e-mail confirmation, exclusions, abuse, sanctions. ## Règles / Rules - Mêmes règles que le formulaire « Rappelez-moi », le connecteur MCP (https://kelki.ai/mcp) et l'Agent Kelki. - Rien n'est transmis sans l'accord de la personne, confirmé par e-mail / Nothing is sent without the person's consent, confirmed by e-mail. - Aucune réponse ne contient la coordonnée d'un professionnel / No response ever contains a professional's contact details. ## Contact - contact@kelki.ai