Compte
Plan, plafonds et consommation du compte partenaire.
Adresse de base : https://kelki.ai/api/v1.
GET /account— Lire le compte, le plan et les plafondsGET /account/usage— Consommation par jour
GET /account
Lire le compte, le plan et les plafonds
Authentification : clé API (Authorization: Bearer kk_…) ou jeton OAuth 2.0 (portée catalog.read).
Réponses
| Code | Description | Contenu |
|---|---|---|
200 | Le compte. | application/json Account |
401 | Identifiants absents, invalides, expirés ou révoqués. | application/problem+json Problem |
Exemple de réponse
{
"id": "acc_01JC00000000000000000000CC",
"name": "Conciergerie Exemple",
"mode": "test",
"plan": "standard",
"live_enabled": false,
"limits": {
"requests_per_minute": 120,
"requests_per_day": 20000,
"live_requests_per_day": 50,
"agent_messages_per_day": 500,
"webhook_endpoints": 5
},
"credential": {
"type": "api_key",
"prefix": "kk_test_Ab12Cd34",
"scopes": [
"catalog.read",
"requests.read",
"requests.write",
"agent"
]
}
}GET /account/usage
Consommation par jour
Authentification : clé API (Authorization: Bearer kk_…) ou jeton OAuth 2.0 (portée catalog.read).
Paramètres
| Nom | Où | Requis | Type | Description |
|---|---|---|---|---|
from | query | oui | string (date) | |
to | query | oui | string (date) |
Réponses
| Code | Description | Contenu |
|---|---|---|
200 | Compteurs par jour (au plus 92 jours). | application/json UsageList |
400 | Requête mal formée (JSON invalide, paramètre inconnu, corps trop gros). | application/problem+json Problem |
401 | Identifiants absents, invalides, expirés ou révoqués. | application/problem+json Problem |
Exemple de réponse
{
"object": "list",
"has_more": false,
"next_cursor": null,
"data": [
{
"date": "2026-11-11",
"calls": 412,
"rate_limited": 0,
"errors": 3,
"drafts_created": 9,
"requests_transmitted": 7,
"requests_sold": 4,
"callbacks_confirmed": 2,
"agent_messages": 31
}
]
}Schémas
Account
| Champ | Type | Requis | Description |
|---|---|---|---|
id | string | oui | |
name | string | oui | Nom affiché dans les e-mails envoyés aux personnes. Fixé par Kelki. |
mode | string | oui | valeurs : |
plan | string | oui | |
live_enabled | boolean | oui | |
limits | object | oui | |
credential | object | oui |
Problem
Détails d'un problème (RFC 9457), avec des membres d'extension.
| Champ | Type | Requis | Description |
|---|---|---|---|
type | string (uri) | oui | URI stable du type de problème ; elle mène à sa documentation. |
title | string | oui | |
status | integer | oui | min. 400 · max. 599 |
detail | string | non | |
instance | string (uri-reference) | non | |
code | string | oui | Code stable, lisible par une machine. valeurs : |
request_id | string | oui | |
errors | tableau de FieldError | non |
UsageList
Type : ListMeta et object
FieldError
| Champ | Type | Requis | Description |
|---|---|---|---|
pointer | string | oui | JSON Pointer (RFC 6901) du champ en cause. |
detail | string | oui | |
allowed | tableau de string | non | Valeurs acceptées, quand la liste est fermée. |
ListMeta
| Champ | Type | Requis | Description |
|---|---|---|---|
object | string | oui | valeur : |
has_more | boolean | oui | |
next_cursor | string | null | oui |