BETA! Please note that our API is still undergoing major updates and is currently available "as is". Should you encounter any problem, please let us know immediately by contacting help@gokickflip.com. Your help is greatly appreciated!
Generating your API access key
We use JWT specifications to generate your access keys. You can read more about it on : https://jwt.io/
To generate a new API key
Log into your Kickflip dashboard.
In the left side bar, under "Account Settings", click on "API keys".
Click on "+ ADD KEY"
You can choose the desired permissions fitting your needs. Keep in mind that this cannot be changed afterwards. You can however generate as much API keys as you want.
Please note that once you've created an API token, you cannot delete it nor modify
its scopes. Be VERY careful not to leak it, so please take the necessary security measures.
E.g. Keep it in a separate configuration instead of hardcoding it in your codebase.
Description of API key scopes
Scope | Description |
Full read and write access | Every endpoint to our API is accessible and you can update the data. |
Full read access | Every GET endpoint to our API is accessible. You cannot update the data. |
Access content of orders | These endpoints only are accessible : |
Access content of designs | These endpoints only are accessible : |
You can then copy your API Key. Like passwords, API keys should remain a secret.
Use this API Key as the bearer token (Authorization header) on every request you make to our endpoint. Here's an example of a call made to GET /designs endpoint using a fake API key with Postman :
