Files
metabuilder/dbal/shared/api/schema/errors.yaml
2025-12-27 13:30:57 +00:00

95 lines
2.4 KiB
YAML

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]