Limites et quotas
L'API est gratuite ; ses plafonds servent de garde-fou. Le plan est attribué par Kelki et peut être relevé au cas par cas.
Plafonds par plan
| Plan | Requêtes / min (par clé) | Requêtes / jour (par compte) | Demandes réelles / jour | Messages à l'Agent / jour | Webhooks |
|---|---|---|---|---|---|
decouverte (bac à sable seul) | 30 | 2 000 | 0 | 50 | 2 |
standard | 120 | 20 000 | 50 | 500 | 5 |
partenaire | 600 | 200 000 | 500 | 5 000 | 10 |
Votre plan, vos plafonds et votre consommation : GET /account et GET /account/usage (92 jours au plus).
Limites communes
- Par adresse IP, avant authentification : 120 requêtes par minute.
- Anti-force brute : au-delà de 20 clés refusées en 10 minutes, l'adresse IP est bloquée temporairement.
- Par contact : 3 demandes au plus par 24 heures pour un même téléphone ou une même adresse e-mail, tous canaux de Kelki confondus (
contact_limit_reached). - Plafond global : 200 demandes API à confirmer par heure, tous comptes confondus.
Ne contournez pas ces limites (plusieurs comptes, clés multipliées, rotation d'adresses) : c'est interdit par la politique d'usage acceptable.
En-têtes
RateLimit-Policy: "minute";q=120;w=60
RateLimit: "minute";r=118;t=42
RateLimit-Policy décrit la politique appliquée à la clé, RateLimit le quota restant (brouillon IETF draft-ietf-httpapi-ratelimit-headers).
Sur une réponse 429
rate_limited: débit par minute dépassé ; attendez la durée deRetry-After, en secondes, avant de réessayer.quota_exceeded: quota du jour atteint ; inutile de réessayer avant le lendemain.- Espacez les nouveaux essais (attente croissante) et ne relancez jamais une création sans le même
Idempotency-Key(idempotence).