Effective error handling is essential for ensuring a smooth developer experience and building robust applications. This guide provides an overview of the errors you may encounter when interacting with the IXO Spatial Web API.

​
Error Response Structure

The IXO Spatial Web API provides informative error responses in JSON format: 
{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "details": [
      {
        "field": "entityId",
        "error": "Missing required parameter"
      }
    ]
  }
}

​
Response Fields

  • code: HTTP status code
  • message: Human-readable error description
  • details: Additional error information

​
Best Practices

​
Common Error Solutions

400 Bad Request

Solution: Double-check request syntax and parameters

401 Unauthorized

Solution: Verify access token and re-authenticate if needed

403 Forbidden

Solution: Verify user permissions and roles

500 Internal Server Error

Solution: Retry after delay or contact support
Always log and monitor errors to identify patterns and improve error handling in your applications.