Getting started
What you need for getting started with API Gateway
To use API Gateway and other Boostrs services, you need a Boostrs business account. If you don't have an account, reach out to us via the customer support email [email protected].
Where supported, the
Accept-Language header will influence the translations used for results. The en flag is the the default one used if no flag is specified.The following languages will be returned by default, unless otherwise requested:
en- English (default)fr- Frenchde- Germanes- Spanishit- Italian
When the translations parameter is used, the content will be returned in all 5 languages by default.
With the
translation_language parameter you can get maximum 5 translations, per the requested language codes.The complete list of available languages:
ISO Language | ISO 639-1 code | Availability |
|---|---|---|
English | en | Default |
French | fr | Default |
German | de | Default |
Italian | it | Default |
Spanish | es | Default |
Arabic | ar | Extra Language pack* |
Bulgarian | bg | Extra Language pack* |
Croatian | hr | Extra Language pack* |
Czech | cs | Extra Language pack* |
Danish | da | Extra Language pack* |
Dutch | nl | Extra Language pack* |
Estonian | et | Extra Language pack* |
Finnish | fi | Extra Language pack* |
Greek | el | Extra Language pack* |
Hungarian | hu | Extra Language pack* |
Icelandic | is | Extra Language pack* |
Irish | ga | Extra Language pack* |
Latvian | lv | Extra Language pack* |
Lithuanian | lt | Extra Language pack* |
Maltese | mt | Extra Language pack* |
Norwegian | no | Extra Language pack* |
Polish | pl | Extra Language pack* |
Portuguese | pt | Extra Language pack* |
Romanian | ro | Extra Language pack* |
Slovak | sk | Extra Language pack* |
Slovenian | sl | Extra Language pack* |
Swedish | sv | Extra Language pack* |
The Extra Language pack is available on request.
If you have any questions regarding the translations, you need to upgrade your account or need any help, reach out by sending us an email at [email protected].
- 1.You will be provided with a
CLIENT_IDandCLIENT_SECRET - 2.Using that information a token can be generated by doing a request to
POST /oauth/tokenusing the credentials - 3.The response will contain a
tokenand the number of seconds until expiration - 4.Until the token expires, all authenticated requests must contain the header
Authorization: Bearer <TOKEN>
This section includes the generic, optional header parameters you can use in your API calls.
get
Generic header parameters (optional)
The Boost.rs API only allows a set number of requests during a small unit of time. These values are prone to change, but the necessary information will be available in every response through the following headers:
Header Key | Description |
|---|---|
X-Request-Quota-Limit | The total quota (monthly number of API calls). |
X-Request-Quota-Limit-Remaining | Remaining (available) number of API calls from your total quota. |
X-RateLimit-Limit | The maximum number of requests in the time window |
X-RateLimit-Remaining | The number of seconds to wait before trying again to avoid the error |
Retry-After | The number of seconds to wait before trying again to avoid the error |
X-RateLimit-Reset | The UNIX timestamp when the limit will be lifted. It will be equal to the value of the current timestamp + Retry-After |
Once authenticated, responses will always have
Content-type: application/json and will have the following format:{
"success": true, // or false if there was an error
"message": "", // will contain error messages
"result": null // will contain api results
}
Going over the rate limit will result in a
429 Too Many Requests HTTP error with the following response:{
"message": "Too Many Attempts.",
"success": false,
"result": null
}
Last modified 6mo ago