Error Codes

Game Framework API error codes and meanings.

HTTP Status Codes

2xx Success

• 200 OK - Request succeeded
• 201 Created - Resource created
• 204 No Content - Success, no response body

4xx Client Errors

• 400 Bad Request - Invalid request
• 401 Unauthorized - Authentication required
• 403 Forbidden - Insufficient permissions
• 404 Not Found - Resource not found
• 409 Conflict - Resource conflict (e.g., version exists)
• 422 Unprocessable Entity - Validation failed
• 429 Too Many Requests - Rate limit exceeded

5xx Server Errors

• 500 Internal Server Error - Server error
• 503 Service Unavailable - Temporary unavailable

Error Response Format

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication required",
    "details": {
      "field": "token",
      "issue": "expired"
    }
  }
}

Common Error Codes

unauthorized

HTTP 401

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication required"
  }
}

Solution: Provide valid token.

forbidden

HTTP 403

{
  "error": {
    "code": "forbidden",
    "message": "Insufficient permissions"
  }
}

Solution: Request necessary permissions.

not_found

HTTP 404

{
  "error": {
    "code": "not_found",
    "message": "Package not found"
  }
}

Solution: Check package name/ID.

validation_failed

HTTP 422

{
  "error": {
    "code": "validation_failed",
    "message": "Validation failed",
    "details": {
      "name": ["Package name must be lowercase"]
    }
  }
}

Solution: Fix validation errors.

rate_limit_exceeded

HTTP 429

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded",
    "retry_after": 3600
  }
}

Solution: Wait and retry.

Next Steps

• API Overview - API basics
• Troubleshooting - Error solutions