Files
metabuilder/dbal/shared/api/schema/errors.json
2026-03-09 22:30:41 +00:00

119 lines
3.1 KiB
JSON

{
"error_codes": {
"NOT_FOUND": {
"code": 404,
"message": "Resource not found",
"description": "The requested entity does not exist",
"http_status": 404
},
"CONFLICT": {
"code": 409,
"message": "Resource conflict",
"description": "The operation conflicts with existing data (e.g., duplicate key)",
"http_status": 409
},
"UNAUTHORIZED": {
"code": 401,
"message": "Authentication required",
"description": "User must be authenticated to access this resource",
"http_status": 401
},
"FORBIDDEN": {
"code": 403,
"message": "Access forbidden",
"description": "User does not have permission to perform this operation",
"http_status": 403
},
"VALIDATION_ERROR": {
"code": 422,
"message": "Validation failed",
"description": "Input data failed validation checks",
"http_status": 422,
"fields": [
{
"field": "string",
"error": "string"
}
]
},
"RATE_LIMIT_EXCEEDED": {
"code": 429,
"message": "Rate limit exceeded",
"description": "Too many requests in a given time window",
"http_status": 429,
"retry_after": "integer"
},
"INTERNAL_ERROR": {
"code": 500,
"message": "Internal server error",
"description": "An unexpected error occurred",
"http_status": 500
},
"TIMEOUT": {
"code": 504,
"message": "Operation timeout",
"description": "The operation took too long to complete",
"http_status": 504
},
"DATABASE_ERROR": {
"code": 503,
"message": "Database unavailable",
"description": "Cannot connect to database",
"http_status": 503
},
"CAPABILITY_NOT_SUPPORTED": {
"code": 501,
"message": "Feature not supported",
"description": "The backend does not support this operation",
"http_status": 501
},
"SANDBOX_VIOLATION": {
"code": 403,
"message": "Sandbox security violation",
"description": "Operation attempted to access restricted resources",
"http_status": 403,
"security_incident": true
},
"MALICIOUS_CODE_DETECTED": {
"code": 403,
"message": "Malicious code detected",
"description": "Input contains potentially harmful code",
"http_status": 403,
"security_incident": true
}
},
"error_handling": {
"retry_strategy": {
"retryable_codes": [
"TIMEOUT",
"DATABASE_ERROR"
],
"max_retries": 3,
"backoff": "exponential",
"initial_delay_ms": 100,
"max_delay_ms": 5000
},
"logging": {
"always_log": [
"INTERNAL_ERROR",
"SANDBOX_VIOLATION",
"MALICIOUS_CODE_DETECTED"
],
"include_stack_trace": [
"INTERNAL_ERROR",
"DATABASE_ERROR"
]
},
"security": {
"audit_required": [
"SANDBOX_VIOLATION",
"MALICIOUS_CODE_DETECTED",
"UNAUTHORIZED"
],
"alert_admin": [
"SANDBOX_VIOLATION",
"MALICIOUS_CODE_DETECTED"
]
}
}
}