Error Messages

Errors are sent from server to client in the following format:

{
  "event": "error",
  "error": {
    "errorCode": 9007,
    "errorLabel": "INVALID_API_KEY",
    "errorDescription": "Invalid API key or IP not allowed"
  }
}

Common Error Codes

CodeLabelDescription
9003SERVICE_UNAVAILABLEService temporarily unavailable
9004TOO_MANY_REQUESTSToo many requests
9005INTERNAL_SERVER_ERRORInternal server error
9006MISSING_API_KEYMissing X-APIKEY header
9007INVALID_API_KEYInvalid API key or IP not allowed
1003INVALID_JSONInvalid JSON

Behavior notes:

  • For authentication/connection-level errors, server sends an error payload and closes the connection.
  • For INVALID_JSON, server sends an error payload and keeps the connection open.