Fehler & Limits

Der Fehler-Umschlag

Jeder Fehler verwendet eine stabile Form – und gibt niemals interne Mandanten-IDs oder Backend-Fehlertext preis:

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

Verzweigen Sie auf code, nicht auf message – Nachrichten können umformuliert werden; Codes sind stabil.

Request-IDs

Jede Antwort trägt X-Request-Id. Senden Sie Ihre eigene (1–128 Zeichen; erstes Zeichen alphanumerisch, danach A-Za-z0-9._:-), um eine Anfrage durch den Conare-Edge und die Memory-Plane zu korrelieren; andernfalls generiert Conare eine. Zitieren Sie sie in jeder Support-Anfrage.

Statuscodes

Status	Bedeutung	Was zu tun ist
`400`	Ungültige Anfrage (z. B. `model_not_served`, unbekannte Collection-ID)	Anfrage korrigieren – die Nachricht sagt genau, was falsch ist
`401`	Fehlender oder ungültiger Schlüssel	Bearer-Token prüfen
`402`	Nutzungskontingent und Overage-Budget erschöpft	Antwort enthält Balance-/Reset-Metadaten – anzeigen, nicht blind wiederholen
`403`	Schlüssel hat den erforderlichen Scope nicht	Den Scope für die Integration gewähren
`409`	Versionskonflikt im Quell-Lebenszyklus	Siehe quell-eigene Erinnerungen – bedeutet meist „bereits durabel”
`413`	Inhalt zu groß	Payload teilen
`429`	Rate-limited	Gemäß den Rate-Limit-Headern zurücksetzen
`503`	Backend nicht bereit (z. B. `integration_unbillable`)	Mit Backoff wiederholen; `/api/v1/status` prüfen

Degradation statt Fehler

Wo ein günstigerer Fallback existiert, degradiert Conare, statt einen Fehler auszulösen:

Deep Recall bei erschöpftem Legacy-Kontingent gibt { answer: null, results: [...], deepUsed: false } zurück – Sie erhalten weiterhin gerankte Roh-Erinnerungen.
Vorschläge haben keinen sinnvollen Shallow-Fallback, daher ist die Erschöpfung ein hartes 402 (Legacy-Kontingent-Tarife: 429).
Fehlerhafte Modell-Ausgabe bei Vorschlägen gibt { suggestions: [], raw: "<text>" } zurück – behandeln Sie raw als anzeigbaren Fallback-Text.

Nie gezählt

Session-Ingest, save und Shallow-Search/Recall werden in keinem Tarif jemals gezählt. Ausgaben-Warnungen feuern bei 75/90/100 %, und die Standardeinstellung ist ein hartes Stopp – keine überraschenden Überschreitungen.

Erste Schritte

Grundlagen

Fehler & Limits

Der Fehler-Umschlag

Request-IDs

Statuscodes

Degradation statt Fehler

Nie gezählt

​Der Fehler-Umschlag

​Request-IDs

​Statuscodes

​Degradation statt Fehler

​Nie gezählt

Der Fehler-Umschlag

Request-IDs

Statuscodes

Degradation statt Fehler

Nie gezählt