Помилки та ліміти

Error envelope

Кожна помилка використовує одну стабільну форму — і ніколи не витікає внутрішніх tenant-ID чи backend-тексту помилки:

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

Гілкуйтеся за code, а не за message — повідомлення можуть переформульовуватися; коди стабільні.

Request ID

Кожна відповідь несе X-Request-Id. Надсилайте свій (1–128 символів; перший — alphanumeric, далі A-Za-z0-9._:-), щоб корелювати один запит через Conare edge та memory-plane; інакше Conare генерує його. Цитуйте його в будь-якому support-запиті.

Status codes

Status	Значення	Що робити
`400`	Невалідний запит (напр. `model_not_served`, невідомий collection ID)	Виправте запит — повідомлення точно каже, що не так
`401`	Відсутній чи невалідний ключ	Перевірте Bearer-токен
`402`	Usage allowance та overage-бюджет вичерпані	Відповідь містить balance/reset метадані — покажіть їх, не сліпо ретрайте
`403`	Ключу бракує потрібного scope	Надайте scope на Integration
`409`	Version-конфлікт на source lifecycle	Див. source-owned спогади — зазвичай означає «вже durable»
`413`	Контент завеликий	Розбийте payload
`429`	Rate-обмежено	Backoff за rate-limit headers
`503`	Backend не готовий (напр. `integration_unbillable`)	Ретрайте з backoff; перевірте `/api/v1/status`

Degradation замість збою

Там, де існує дешевший fallback, Conare деградує, а не помиляється:

Deep recall на вичерпаній legacy-квоті повертає { answer: null, results: [...], deepUsed: false } — ви все одно отримуєте ранжовані raw-спогади.
Suggestions не має осмисленого shallow-fallback, тож вичерпання — hard 402 (legacy quota-плани: 429).
Malformed model output на suggestions повертає { suggestions: [], raw: "<text>" } — трактуйте raw як displayable fallback-текст.

Ніколи не обліковується

Session ingest, save та shallow search/recall ніколи не обліковуються, на жодному плані. Spend-алерти спрацьовують на 75/90/100%, а дефолтом є hard-stop — жодних сюрприз-overages.

Початок роботи

Основи

Помилки та ліміти

Error envelope

Request ID

Status codes

Degradation замість збою

Ніколи не обліковується

​Error envelope

​Request ID

​Status codes

​Degradation замість збою

​Ніколи не обліковується

Error envelope

Request ID

Status codes

Degradation замість збою

Ніколи не обліковується