boostrs api
Search…
Getting started
What you need for getting started with API Gateway

Prerequisites

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].

Languages

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 language codes are defined according to ISO 639-1 list.
The following languages are currently available:
  • en - English (default)
  • fr - French
  • de - German
  • es - Spanish
  • it - Italian
When the translations parameter is used, the content will be returned in all 5 languages by default.

Authentication

The Boostrs API uses OAuth 2.0 Client Grant in order to authenticate clients.
  1. 1.
    You will be provided with a CLIENT_ID and CLIENT_SECRET
  2. 2.
    Using that information a token can be generated by doing a request to POST /oauth/token using the credentials
  3. 3.
    The response will contain a token and the number of seconds until expiration
  4. 4.
    Until the token expires, all authenticated requests must contain the header Authorization: Bearer <TOKEN>

Request Header - parameters

This section includes the generic, optional header parameters you can use in your API calls.
get
Generic header parameters (optional)

Response Header - limits

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

Response Body - format

Once authenticated, responses will always have Content-type: application/json and will have the following format:
1
{
2
"success": true, // or false if there was an error
3
"message": "", // will contain error messages
4
"result": null // will contain api results
5
}
Copied!
Going over the rate limit will result in a 429 Too Many Requests HTTP error with the following response:
1
{
2
"message": "Too Many Attempts.",
3
"success": false,
4
"result": null
5
}
Copied!