Aller au contenu
KelkiDéveloppeurs

Guide : affiliation avec l'API

Votre compte partenaire Kelki est aussi un compte de l'API. Les demandes créées avec vos identifiants de production portent automatiquement votre code partenaire (KA-…) : 20 % du prix hors taxe de chaque demande achetée par un professionnel vous revient, comme pour les modules intégrés.

Le principe

  1. Un seul compte. Le compte partenaire (code KA-…) et le compte API (acc_…) sont le même compte. Votre espace partenaire vous donne votre secret développeur, qui ouvre l'espace développeur : clés de test d'abord, clés de production après validation par Kelki.
  2. Rien à ajouter. Une demande créée par POST /requests puis confirmée par la personne (e-mail « Confirmer ma demande ») porte votre code. Les conversations de l'Agent (/agent/conversations) aussi : leur demande passe par la même confirmation.
  3. Suivi. Vos demandes, leurs statuts (à confirmer, en cours, vendue, non vendue) et vos commissions s'affichent dans votre espace partenaire, sans aucune donnée personnelle.

En-tête facultatif Kelki-Affiliate

Pour l'écrire explicitement dans vos appels (journalisation, vérification), envoyez votre code dans l'en-tête Kelki-Affiliate. Il doit désigner le code de VOTRE compte : un autre code renvoie 403 insufficient_scope.

curl -X POST https://kelki.ai/api/v1/requests/req_01JC…/confirmation \
  -H "Authorization: Bearer kk_live_…" \
  -H "Kelki-Affiliate: KA-1042" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f1c…" \
  -d '{"method": "email", "consent_given": true, "consent_text_version": "v2026-10-18"}'

Les règles de la commission

Les modules à copier-coller (formulaire « Rappelez-moi », Agent Kelki) et les conditions du programme : programme partenaires, conditions.