HTTP Response Codes and Errors

From Oxygen.next Wiki

Jump to: navigation, search

HTTP Status Codes The Oxygen API attempts to return appropriate HTTP status codes for every request.

  • 200 OK: Success!
  • 304 Not Modified: There was no new data to return.
  • 400 Bad Request: The request was invalid. An accompanying error message will explain why. This is the status code will be returned during rate limiting.
  • 401 Not Authorized: Authentication credentials were missing or incorrect.
  • 403 Forbidden: The request is understood, but it has been refused. An accompanying error message will explain why.
  • 404 Not Found: The URI requested is invalid or the resource requested does not exists.
  • 500 Internal Server Error: Something is broken. Please post to the forum so the development team can investigate.
  • 502 Bad Gateway: Oxygen API is down or being upgraded.
  • 503 Service Unavailable: The Oxygen servers are up, but overloaded with requests. Try again later.

API Return Codes The Oxygen API in some cases returns Messages which include a Number.

  • 0 OK: Everything is great!
  • 1 General Exception: Something went wrong, read the Message to get more info!
  • 2 Security Exception: You tried to do something the current User isn't allowed to!