RAGcore-Public/docs/06_API/ERROR_MODEL.md

Error Model

Alle API-fouten gebruiken application/problem+json:

{
  "type": "https://ragcore.example.test/problems/space-forbidden",
  "title": "Knowledge space access denied",
  "status": 403,
  "code": "SPACE_FORBIDDEN",
  "detail": "The caller is not allowed to use one or more requested spaces.",
  "trace_id": "..."
}

Regels

• code is stabiel en machineleesbaar.
• detail bevat geen secrets, SQL, filesystemroots of providerkeys.
• Validation errors bevatten veldpaden en veilige redenen.
• Provider/downstream errors worden gemapt naar RAGCore-codes.
• Retryable errors geven optioneel retry_after_seconds.
• 404 mag voor gevoelige resources worden gebruikt waar 403 bestaan zou lekken.