XML vs. JSON
It is up to you to decide whether you prefer JSON or XML formatting of data. Simply specify this option when connecting.
For XML we recommend Internet Explorer for your tests. For JSON then we recommend Google Chrome. IE is not capable of displaying JSON results.
Please remember that API PUT methods cannot be run from within a browser.
Error handling
In the case of errors such as encountered with invalid parameters or an unauthorized access, the service method will return a standard HTTP error code together with a text message. This text message typically is not displayed when executing API methods in a browser.
The status codes used by the API are:
HTTP Status Code | Reason |
200 | OK. Operation succeeded. |
400 | Bad request. Used when the method was not called with correct parameters. Check error message for details. |
401 | Unauthorized. An attempt was made to first connect to the API with an invalid password or IP address. Also occurs if the API is not activated for your Wordbee Translator. |
403 | Forbidden. An attempt was made to access the API with an invalid or expired token. |
404 | Not found. Occurs when you request information for a specific object but this object does not exist. E.g. requesting project details for a deleted project. |
500 | Internal server error. An unspecified error occurred. Contact Wordbee for assistance. |