Overview

Welcome to Kandio, we're happy to see you here. You'll start building powerful integrations to Kandio, by using our API, in no time! Read about the basics below and then browse through the documentation to learn more about integrating to Kandio and explore our APIs.

The basics

• Kandio's REST api follows the standard structure of handling entity ID in the JSON response model. All request and response data have to be in JSON.

• All endpoints come with pagination. If you handle your API calls using offset, you should be good to go. Please be aware that some endpoints do not return a total. Instead, you have to make sure your code identifies whether you have to query for more pages.

• Access to the Kandio's API is secured by a standard Oauth2 flow with a bearer token (Authorization Code flow). Learn more under Authentication.

• In order to prevent unintended issues, our default rate limits will ensure top performing environments.

  • Requests per minute: 1000

• You can monitor your current status by examining two HTTP headers that are returned with each request you make:

  • X-RateLimit-Limit: The ceiling for the request you just made

  • X-RateLimit-Remaining: The number of requests you have left for the current 1 hour window

• You can get your API key and Secret from your organization settings area on Kandio.

Explore APIs

• Go to the APIs section in the footer of kand.io. From there you can explore our APIs by navigating in the API menu on the right-hand side.