API Host and Environments
Kable is accessible in Live and Test environments. You will have separate API keys to access each environment.
You should only use Kable's Live environment for your own production data. Any configured non-production environments you may use should use Kable's Test environment.
API Protocols and Headers
All requests to the Kable API are made over HTTPS TLS v1.2+ to ensure security. Calls made over HTTP will fail. Any requests without proper authentication will also fail.
The Kable API uses standard JSON for requests and responses. Be sure to set both the Content-Type
and Accept
headers on each request to application/json
.
Each Kable API response includes a requestId
as the X-REQUEST-ID
response header where possible. The requestId
is included regardless whether the API request succeeded or failed. You can use this requestId
to help with debugging or when contacting support regarding a specific API call.
API Authentication
All requests to the Kable API are authenticated using API keys. You can find your keys on the Company page of your dashboard.
You must provide your Kable Client ID as the KABLE-CLIENT-ID
header and your secret key as the KABLE-CLIENT-SECRET
header on each request to Kable. If you are using a language-specific Kable library, you will initialize the SDK using these keys.
Kable as an Authentication Provider
If you use Kable as an authentication provider for your API, your customers will also have a set of API keys managed by Kable as well. These "customer keys" are different from what are described here, and are further explained in the Kable for API Authentication section.
Note that not everyone uses Kable as an Authentication Provider, so this callout may not be relevant to you.
API Versioning
All Kable endpoints are versioned. After the host, each API can be found at /api/vX/...
where X is the API version.
We strive to ensure that changes to the Kable API are backward compatible. Sometimes, though, we must break from older design paradigms to make the product better. When this happens, a new version of the API is released.
The current version of Kable is v1
.