Changelog
Notable changes made to the Wordly API
You can now manage your account using Wordly’s REST APIs. You can view the OpenAPI documentation and try out the APIs yourself over at the API Reference page provided that you have a developer API key.
Please note that the API Reference page acts on live data, so be cautious when using it.
New features will be added regularly, so stay tuned for more updates!
Click here to view the changelog.
A developer API key must be included as a header for all requests. You must have a Wordly account, and your account must be added to an allow list before you can create and use an API key. You can request to have your account added by contacting Wordly Support.
Once your account has been added to the allow list, you can create a non-expiring API key in the Portal by following these steps:
If you do not see the API Key row in your profile, then your account has not been added to the allow list.
It is imperative that this key be kept secret for security reasons; otherwise, a malicious actor can impersonate as you and access your account through the APIs. Therefore, do not share this key without understanding the risks in doing so.
If you suspect your account has been compromised, delete your API key immediately.
The following section will help get you started in using Wordly’s REST APIs. You can view the Open API documentation and try out the API yourself over at https://api.wordly.ai/reference.
In order to use the API, you must include the x-wordly-api-key
header with every request. The value of this header is your developer API key.
Example: x-wordly-api-key: f716690b-4e9a-4656-9523-7003637eb6cc
Failure to provide the API key in the header will result in a 401 (i.e., unauthorized) response from the server.
As new versions of the API are released, the request and response body schemas may change.
Wordly will include the x-wordly-api-version
header in every response which tells you which version of the API the response body is conforming to.
Example: x-wordly-api-version: 1.0
Conversely, you can provide the x-wordly-api-version
header in your requests to pin the request and response body schema to a specific API version. This ensures that your requests will continue to work when new versions of the API are released.
If you do not provide the x-wordly-api-version
header in your requests, then Wordly will assume the latest API version. Therefore, we strongly recommend that you include this header with every request.
If an error occurs while processing your request, you will receive an HTTP error response. In most cases, you will receive a JSON response body in the following format:
{
"message": "An error message will be here.",
"code": 2003,
"errors": [
{
"message": "Any additional error information..."
},
{
"message": "...will be listed here."
}
]
}
The code field is a numeric error code that is specific to Wordly. The table below is a list of possible error codes that you may receive in an error response.
Error Code | Description |
---|---|
2003 | Not authorized to perform this action. |
2026 | A field is not valid. |
2041 | Operation cannot be completed because the session is in use. |
5001 | Required fields are missing from the request. |
5002 | A field is not valid. |
5004 | Requested resource could not be found. |
If you wish to delete and revoke your API key, then you can do so through the Portal. You are free to generate a new API key after deleting your existing one.
Follow these steps to delete your API key:
Notable changes made to the Wordly API
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.