Errors

This page serves as a reference for the different status codes that the Cevoid API may return. As a developer, understanding the outcome of your requests is crucial, and this page will help you do just that.


Status codes

Here is a list of the different categories of status codes returned by the Cevoid API. Use these to understand if a request was successful.

  • Name
    200
    Type
    Description

    A 200 status code indicates a successful response.

  • Name
    400
    Type
    Description

    A 400 status code indicates a bad request—this means it's a you problem.

  • Name
    401
    Type
    Description

    A 401 status code indicates that you are not authorized to make the request.

  • Name
    402
    Type
    Description

    A 402 status code indicates that the parameters were valid but the request failed.

  • Name
    403
    Type
    Description

    A 403 status code indicates that you are not allowed to make the request.

  • Name
    404
    Type
    Description

    A 404 status code indicates that the resource you are trying to access does not exist.

  • Name
    500
    Type
    Description

    A 500 status code indicates a server error — something went wrong on Cevoid's end.


Error types

Whenever a request is unsuccessful, the Cevoid API will return an error response with an error type and message. You can use this information to understand better what has gone wrong and how to fix it. Most of the error messages are pretty helpful and actionable.

Here is a list of the two error types supported by the Cevoid API — use these to understand what you have done wrong.

  • Name
    api_error
    Type
    Description

    This means that we made an error, which is highly speculative and unlikely.

  • Name
    invalid_request
    Type
    Description

    This means that you made an error, which is much more likely.

Error response

{
  "type": "api_error",
  "message": "No way this is happening!?",
  "documentation_url": "https://docs.cevoid.com/errors"
}