API - Connect
You start by connecting to a Beebox project. Upon connection, you obtain a session token. This token is included with all subsequent calls.
For security reasons we recommend the new authentication method using POST rather than GET: https://wordbee.atlassian.net/l/cp/oQnxVBuA
URL
(GET) https://{server}/api/connect?project=&login=&pwd=&waitsecs=&connector=&version=PARAMETERS
The URL parameters are:
project | The identifier of the project to connect to. You can find this id in the project settings page: |
login | You can create credentials individually per each project. Go to the project "Settings", then select "Connectors & API" and create login/password. These credentials can access data in the specific project and basic API methods only. Typically, these credentials would are perfect for CMS (Content Management System) connectors. Alternatively, you can use the administrator credentials. In that case, you need to follow special rules. |
pwd | |
waitsecs | Optional number. Default is 10. Indicates the timeout in seconds for this call. Purpose: Whenever the Beebox executes automated operations, it blocks login attempts. This parameter indicates how long the login method waits before it returns an error. |
connector | Free text that identifies your connector. For example “Drupal by xy”. Keep it a short product name. |
version | Free text containing the version number of your connector. For example "1.1.0". |
RESULTS
The API returns a session token which you include with all subsequent API calls.
It is important to verify the HTTP status code. If authentication succeeds, the method returns HTTP code 200 (success). All other HTTP codes point to an error.
If the server is busy due to a running server operation, the method will wait for the number of seconds specified in the “waitsecs” parameter. If the server is still busy after this period, the method fails with an error id "BUSY". In that case please wait a few seconds and retry.
HTTP status codes
With every API call, you need to check the HTTP error code. 200 and 204 equal success. All other codes point to an error.
DISCONNECTING
Always invalidate your token when you no longer need it. Failing to do so may put on hold automatic operations.
See API - Disconnect.