Aller au contenu
KelkiDéveloppeurs

Authentification

Deux méthodes, toujours dans l'en-tête Authorization, jamais dans l'adresse : une clé API, ou un jeton OAuth 2.0 obtenu avec vos identifiants de client.

Clés API

Authorization: Bearer kk_live_Ab12Cd34_…

OAuth 2.0 client credentials

Pour des jetons courts et des portées réduites par appel (RFC 6749 § 4.4) :

curl -s https://kelki.ai/api/v1/oauth/token -u "$KELKI_CLIENT_ID:$KELKI_CLIENT_SECRET" \
  -d grant_type=client_credentials -d "scope=catalog.read requests.write requests.read"

La réponse donne un jeton opaque kat_<mode>_…, valable 15 minutes, à utiliser en Authorization: Bearer. Les portées demandées doivent avoir été accordées au client ; sans scope, le jeton reçoit toutes les portées du client. Révocation : POST /oauth/revoke (RFC 7009). Les erreurs de ces deux routes suivent le format de RFC 6749 § 5.2 (error, error_description).

Portées

PortéeAccès
catalog.readPays, métiers, prestations, lieux, textes d'accord, compte, consommation.
requests.readLire vos demandes et leur historique.
requests.writeCréer, modifier, annuler un brouillon ; lancer la confirmation par e-mail.
agentConverser avec l'Agent Kelki (l'accord final exige aussi requests.write).
webhooks.manageGérer vos adresses de webhooks.

Donnez à chaque clé ou client le minimum utile. La spécification décrit aussi une portée consent.attest, réservée à des partenaires agréés : elle n'est pas ouverte au lancement (confirmation par e-mail seule).

Rotation et révocation

Seule une clé en lecture seule (catalog.read) peut servir depuis une page web, et seulement pour les origines déclarées pour votre compte. Toute écriture (brouillon, confirmation, agent) se fait depuis votre serveur. L'API n'accepte aucun cookie : l'authentification passe uniquement par l'en-tête.

Bonnes pratiques