Detailed response

DFINERY Import API determines the success or failure of a request through HTTP response code and detailed response code. Even if the HTTP response code is 200, the request may fail.

HTTP response codes

Response Code	Explanation
200 - OK	The request was successfully received by the server.
400 - Bad Request	The request could not be processed. This is the response returned when a required parameter was not sent or the parameter format is incorrect. Please check the request parameters.
429 - Too Many Requests	An unusually high number of requests have been sent. Please try again later.
500 - Server Error	An error occurred inside the server.

Detailed response code

If an API call fails, you can get detailed information about the error via the detailed response code.

Response Code	Code	Message	Explanation
200	20000	OK	Request successful
200	40000	BAD_REQUEST	Invalid request
200	40001	VALIDATION_FAILURE	Verification failed
200	40101	INVALID_SERVICE_ID	Invalid service ID
200	40201	INVALID_TOKEN	Invalid token provided
200	40401	TOO_MANY_REQUEST	API usage limit exceeded
200	40402	TOO_MANY_EVENTS	Number of events in request exceeded
200	40403	TOO_MANY_USER_PROFILES	Exceeded number of user profiles in a single request
200	50000	INTERNAL_SERVER_ERROR	An internal server error occurred

Example response

20000 OK

200 OK
{
  "status": true,
  "code": 20000,
  "message": "OK",
  "data": null 
}

40001 VALIDATION_FAILURE

200 OK
{
  "status": false,
  "code": 40001,
  "message": "VALIDATION_FAILURE",
  "data": null 
}

50000 INTERNAL_SERVER_ERROR

200 OK
{
  "status": false,
  "code": 50000,
  "message": "INTERNAL_SERVER_ERROR",
  "data": null 
}