Les pages de chaque parcours détaillent le moment où le code apparaît. Ce tableau les regroupe.
id |
HTTP | Quand |
|---|---|---|
phone_already_in_use |
409 | Onboarding : le téléphone a déjà un compte. Enchaînez avec un rattachement |
user_not_found |
404 | Rattachement : aucun utilisateur pour ce téléphone. Utilisez l'onboarding |
no_owned_business |
409 | L'utilisateur existe mais n'est Owner d'aucune entreprise |
already_linked |
409 | Rattachement déjà en place. extras contient le merchantBusinessId |
not_linked |
404 | Détachement, ou assignation de catalogue, sans rattachement live |
compliance_level_0_incomplete |
409 | KYC alors que les champs niveau 0 sont incomplets |
kyc_required |
409 | KYB avant un KYC succeeded |
fee_catalog_not_found |
404 | Catalogue absent, qui ne vous appartient pas, ou supprimé |
fee_catalog_assignment_not_found |
404 | Aucun catalogue assigné à retirer |
fee_catalog_still_assigned |
409 | Suppression tableau de bord d'un catalogue encore assigné |
max_webhook_subscriptions_reached |
409 | Un abonnement webhook actif existe déjà sur votre magasin dédié |
forbidden_action |
403 | storeId d'un autre magasin avec une clé plateforme |
business_not_service_provider |
403 | Compte plateforme suspendu. Voir Suspension |
Sans id dédié :
- 401 sur une vérification de conformité : le marchand n'est pas rattaché à votre plateforme. Après un détachement, les clés plateforme que vous aviez créées répondent aussi 401.
- 403 à la création de clé : le
merchantBusinessIdn'est pas un marchand que vous avez intégré ou rattaché. - 404 sur une vérification, une demande de rattachement ou un abonnement webhook : ressource inconnue, ou elle appartient à un autre plateforme.
- 422 : valeur hors des données de référence, fourchette de revenu inversée, ou URL de webhook qui n'est pas en https.
Limitation de débit
Pour garantir la stabilité et la disponibilité de l'API, Kelyko applique des limites de débit au niveau applicatif.
Point d’attention.
Les limites sont appliquées par entreprise, et non par clé API. La création de plusieurs clés API ne permet pas de contourner les limites.
| Type de limite | Quota | Fenêtre de temps |
|---|---|---|
| Limite standard | 500 requêtes | par minute |
| Limite burst | 1 000 requêtes | par 5 minutes |
En cas de dépassement, l'entreprise est bloquée 10 à 15 minutes. Pendant le blocage, les requêtes reçoivent 429 Too Many Requests.
{
"statusCode": 429,
"error": "Too Many Requests",
"message": "Rate limit exceeded. Please retry after some time."
}
async function makeRequestWithRetry(url, options, maxRetries = 5) {
for (let attempt = 0; attempt < maxRetries; attempt++) {
const response = await fetch(url, options);
if (response.status === 429) {
const waitTime = Math.pow(2, attempt) * 1000;
await new Promise(resolve => setTimeout(resolve, waitTime));
continue;
}
return response;
}
throw new Error('Nombre maximum de tentatives dépassé');
}
Point d’attention.
Si vous avez besoin de limites plus élevées, contactez *contact-a-renseigner@kelyko.invalid*.