Request Types, Permissions, Errors, & Limits

Website Guide & Tutorial Blog Book a Demo

Search…

CREATING REQUESTS
According to RESTful structure, Acquire implements the following HTTP verbs:

GET - Read entity
POST - Create new entity
PUT - Modify existing entity
DELETE - Remove entity
PERMISSIONS
To request any API endpoint, you will need a valid API key with the related access permissions.
Learn more about obtaining an API key and access permissions in the Authorization section. 
Errors
Errors are returned using standard HTTP error codes.
In general, the list of error codes includes:

Code
Explanation
2xx
Success
4xx
Bad request sent to the server
5xx
Server-side error
STATUS CODES
200 OK Successful request.
400 Bad Request Returns JSON with the error message.
401 Unauthorized Couldn’t authenticate your request.
403 Forbidden Invalid request.
404 Not Found No such object.
500 Internal Server Error Something went wrong.
503 Service Unavailable Service is down for maintenance.
Types
Code
Explanation
ERROR_INVALID_INPUT
400
Invalid request
ERROR_RECORD_NOT_FOUND
400
No credentials in the request body
ERROR_DUPLICATE_RECORD_FOUND
400
Already exists
ERROR_UNAUTHORIZED
401
Missing, incorrect, or invalid API Key
ERROR_UNAUTHORIZED_ACCESS
403
Invalid request
ERROR_SERVER_ERROR
500
Internal server error
API Limit
There are no API consumption limits.

Last modified 7mo ago

Copy link

Contents