API responses - Beem API

This section describes HTTP status codes and corresponding API responses returned by the MOJA APIs.

Success responses

Successful requests return HTTP 200. What the response contains depends on the operation:

Operation	What you get back
Send session message	Confirmation that the message was sent
Get active sessions	List of active chat sessions
List message templates	Paginated template list
Send template message	Template broadcast result with validation and pricing details
Inbound message callback	Your server should respond with `200` and an acknowledgement JSON body
Template delivery report callback	Your server should respond with `200` after receiving the DLR payload

HTTP status	Description
`401`	Invalid Authentication Parameters (`api_key` or `secret_key` is incorrect).
`400`	No authorization headers provided.

HTTP/1.1 401 Unauthorized
{
  "code": 120,
  "message": "Invalid Authentication Parameters"
}

HTTP status	Description
`400`	Bad Request — invalid or malformed request body.

HTTP status	Description
`404`	The session has expired or resource not found.

HTTP status	Description
`500`	Internal Server Error.