Instructions
...
API returns appropriate HTTP status code for every request.
| HTTP Code | Text | Description |
|---|---|---|
| 200 | OK | Success |
| 400 | Bad Request | The request was invalid or cannot be otherwise served |
| 401 | Unauthorized | Missing or incorrect authentication credentials |
| 403 | Forbidden | The request is understood, but it has been refused or access is not allowed |
| 404 | Not Found | The requested resource does not exist |
| 405 | Method not allowed | The method received in the request-line is known by the origin server but not supported by the target resource |
| 415 | Unsupported Media Type | Request header is missing content-type (e.g. application/json) |
| 429 | Too many requests | The user has sent too many requests in a given amount of time ("rate limiting") |
| 500 | Internal Server Error | Unspecified server error |
Error Messages
...
| Code Block |
|---|
{"errors":[{"errorCode":5000, "message":"validation error", "subject":"firstName", "subjectType":"parameter"}]} |
Error Codes
In addition to descriptive error message, errors contain error codes. While the text for an error message may change, the codes will stay the same. If an error response is not listed in the table or missing, fall back to examining the HTTP status codes above.
| Error Code | Message | Description |
|---|---|---|
| 2006 | entity saving error | Error occurred while saving the entity. |
| 200601 | entity saving error: USPTA number must be unique | Error occurred while saving the entity. USPTA number must be unique. |
| 200602 | entity saving error: PTR number must be unique | Error occurred while saving the entity. PTR number must be unique. |
| 3001 | entity not found | Entity was not found. |
| 3002 | entity already exists | Same entity already exists and cannot be created. |
| 4003 | authentication token is invalid | Authentication token is not valid. |
| 4004 | authentication error | Unknown authentication error occurred. |
| 4005 | backend system token is invalid | Authorization token for backend system call is not valid therefore request cannot be completed. |
| 4006 | access denied | Access is denied. |
| 5000 | validation error | Validation error. Additional attributes "subject" and "subjectType" may be present in response containing additional information (e.g. field name). |
| 5001 | illegal combination of method arguments | Supplied method arguments either invalid or incomplete. |
| 5002 | entity id is empty | Entity primary key is empty, request cannot be completed. |
| 5003 | unknown identifier error | Unknown entity identifier error. |
| 5004 | no remaining amount | No remaining amount error. |
| 6001 | empty client org | Empty "client org" attribute value. |
| 6002 | empty password | Password cannot be empty. |
| 6003 | invalid client grant type | Invalid "client grant type" value error. |
| 6004 | invalid client profile | Invalid "client profile" value error. |
| 6005 | invalid client scope set | Invalid "client scope" value error. |
| 6006 | new password not match | New passwords do not match. |
| 6007 | wrong password | Wrong password. |
| 9001 | unexpected system error | Unexpected system error. |
| 9002 | HTTP message not readable error | HTTP message not readable error. |
| 9003 | mail trigger error | Error while triggering an email. |
...