Erreurs et limites

L’enveloppe d’erreur

Chaque erreur utilise une forme stable — et ne divulgue jamais d’identifiants de tenant internes ni de texte d’erreur backend :

{
  "statusCode": 409,
  "code": "stale_source_version",
  "message": "Version 6 is older than the applied version 7.",
  "requestId": "req_...",
  "details": { }
}

Faites vos branchements sur code, pas sur message — les messages peuvent être reformulés ; les codes sont stables.

Identifiants de requête

Chaque réponse porte X-Request-Id. Envoyez le vôtre (1–128 caractères ; premier caractère alphanumérique, puis A-Za-z0-9._:-) pour corréler une requête à travers la bordure Conare et le plan mémoire ; sinon Conare en génère un. Citez-le dans toute demande de support.

Codes de statut

Statut	Signification	Que faire
`400`	Requête invalide (par exemple `model_not_served`, ID de collection inconnu)	Corrigez la requête — le message dit exactement ce qui ne va pas
`401`	Clé manquante ou invalide	Vérifiez le jeton Bearer
`402`	Quota d’usage et budget de dépassement épuisés	La réponse inclut les métadonnées de solde/réinitialisation — présentez-les, ne réessayez pas à l’aveugle
`403`	La clé n’a pas la portée requise	Accordez la portée sur l’intégration
`409`	Conflit de version sur le cycle de vie de la source	Voir mémoires détenues par la source — signifie généralement « déjà durable »
`413`	Contenu trop volumineux	Divisez la charge utile
`429`	Limite de taux atteinte	Faites du back-off selon les en-têtes de limite de taux
`503`	Backend pas prêt (par exemple `integration_unbillable`)	Réessayez avec back-off ; vérifiez `/api/v1/status`

Dégradation plutôt qu’échec

Là où existe un repli moins coûteux, Conare se dégrade plutôt que d’échouer :

Rappel approfondi sur un quota hérité épuisé renvoie { answer: null, results: [...], deepUsed: false } — vous obtenez toujours des mémoires brutes classées.
Suggestions n’a pas de repli superficiel significatif, donc l’épuisement est un 402 strict (plans à quota hérité : 429).
Sortie de modèle mal formée sur les suggestions renvoie { suggestions: [], raw: "<text>" } — traitez raw comme texte de repli affichable.

Jamais facturé

L’ingestion de session, save et la recherche/rappel superficiels ne sont jamais facturés, quel que soit le plan. Les alertes de dépense se déclenchent à 75/90/100 % et le comportement par défaut est un arrêt strict — aucun dépassement inattendu.

Démarrer

Fondamentaux

Erreurs et limites

L’enveloppe d’erreur

Identifiants de requête

Codes de statut

Dégradation plutôt qu’échec

Jamais facturé

​L’enveloppe d’erreur

​Identifiants de requête

​Codes de statut

​Dégradation plutôt qu’échec

​Jamais facturé

L’enveloppe d’erreur

Identifiants de requête

Codes de statut

Dégradation plutôt qu’échec

Jamais facturé