KelnaKelnaDocumentation
Parcourir la documentation

DéveloppeursVersion tablette · pilote

Erreurs et reprises

Distinguez une identité refusée, une commande périmée et une réponse réseau incertaine.

Format des erreurs Kelna

Les routes Kelna renvoient généralement un objet { code }. Le proxy Better Auth conserve les formats de sa bibliothèque. Les erreurs de validation de requête deviennent INVALID_REQUEST, sans détail interne de base de données.

Exemple de code
{ "code": "VERSION_CONFLICT" }

Codes à traiter

HTTP / codeTraitement attendu
401 UNAUTHENTICATED / UNPAIREDRétablir la session ou associer à nouveau l’appareil.
403 MFA_REQUIRED / REAUTH_REQUIREDTerminer MFA ou se reconnecter pour obtenir une session récente.
403 FORBIDDEN / INVALID_ORIGINVérifier les permissions et l’origine ; ne pas contourner le contrôle.
400 INVALID_PAIRING / INVALID_INVITATIONFaire préparer un nouveau code ou lien si nécessaire.
409 VERSION_CONFLICT / GROUP_CHANGEDRelire la salle et vérifier l’intention avant une nouvelle commande.
409 ID_CONFLICTNe pas réutiliser un identifiant pour un contenu différent.
409 SERVICE_ALREADY_OPEN / SERVICE_CLOSED / NO_PLANVérifier le service et la préparation du plan.
409 INVALID_TRANSITION / NOTHING_TO_UNDORelire les actions disponibles et canUndo.
409 LAST_OWNER_REQUIREDConserver au moins un Propriétaire ; vérifier l’attribution envisagée.
409 VISION_CONFLICTRelire la version du plan et la révision des réglages expérimentaux.
429 RATE_LIMITEDEspacer les tentatives d’activation ou de jumelage.
503 sur /api/readyLa base initialisée n’est pas disponible ; ne pas conclure que l’API est prête.

Une absence de réponse n’est pas un refus

Le serveur peut avoir enregistré une écriture dont la réponse s’est perdue. Conservez sa commande pour une reprise identique. Une erreur réseau ne doit pas devenir un nouvel événement métier.

Les diagnostics et tickets de support ne doivent contenir ni cookies, ni liens d’activation, ni mots de passe, ni données de personnel.

Besoin d’un coup de main ?

Indiquez l’étape qui bloque et le message affiché. Gardez vos mots de passe et codes de connexion privés.

Contacter l’équipe Kelna