Erreurs et limites

L’enveloppe d’erreur

Chaque erreur utilise une seule forme stable — et ne fuite jamais les IDs internes de tenants ni le texte d’erreur du backend :

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

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

Identifiants de requêtes

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 l’edge et le plan mémoire de Conare ; 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 ex. `model_not_served`, ID de collection inconnu)	Corriger la requête — le message indique exactement ce qui ne va pas
`401`	Clé manquante ou invalide	Vérifier 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 — remontez-les, ne réessayez pas à l’aveugle
`403`	La clé n’a pas le scope requis	Accordez le scope sur l’intégration
`409`	Conflit de version sur le cycle de vie source	Voir mémoires appartenant à une source — signifie généralement « déjà durable »
`413`	Contenu trop volumineux	Divisez le payload
`429`	Limite de débit atteinte	Réduisez le rythme selon les en-têtes de limite de débit
`503`	Backend pas prêt (par ex. `integration_unbillable`)	Réessayez avec backoff ; vérifiez `/api/v1/status`

Dégradation plutôt qu’échec

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

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

Jamais facturé

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

Démarrer

Fondamentaux

Erreurs et limites

L’enveloppe d’erreur

Identifiants de requêtes

Codes de statut

Dégradation plutôt qu’échec

Jamais facturé

​L’enveloppe d’erreur

​Identifiants de requêtes

​Codes de statut

​Dégradation plutôt qu’échec

​Jamais facturé

L’enveloppe d’erreur

Identifiants de requêtes

Codes de statut

Dégradation plutôt qu’échec

Jamais facturé