Pointhub

Http Status

In this guide, we will talk about HTTP Response Status Codes. Status codes are issued by a server in response to a client's request.


2xx Successful

The request was successfully received, understood, and accepted

  • Name
    200 - OK
    Type
    Description

    Everything worked as expected.

  • Name
    201 - Created
    Type
    Description

    A successful response of CREATE requests.

  • Name
    204 - No Content
    Type
    Description

    A successful response of UPDATE or DELETE requests.

Response

{
  ...
}

4xx Client Error

The request contains bad syntax or cannot be fulfilled

  • Name
    400 - Bad Request
    Type
    Description

    The request was unacceptable, often due to missing a required parameter.

  • Name
    401 - Unauthorized
    Type
    Description

    username or password or bearer-token invalid.

  • Name
    403 - Forbidden
    Type
    Description

    The API key doesn't have permissions to perform the request.

  • Name
    404 - Not Found
    Type
    Description

    The requested resource doesn't exist.

  • Name
    422 - Unprocessable Entity
    Type
    Description

    Validation Fails.

  • Name
    429 - Too Many Requests
    Type
    Description

    Hit the API too quickly. We recommend an exponential backoff of your requests.

Error Response

{
  "code": 400,
  "status": "Bad Request",
  "message": "The server cannot process the request."
}

5xx Server Error

The server failed to fulfil an apparently valid request

  • Name
    500 - Internal Server Error
    Type
    Description

    Something went wrong on server.

Error Response

{
  "code": 500,
  "status": "Internal Server Error",
  "message": "An unexpected condition was encountered."
}