Skip to content
Start free Sign in

Developers and API

Guides for the Kukie.io API: create an API key, make your first request, handle errors, rate limits, retries, lists and versions, and receive webhooks.

Articles

  1. Make your first API request Create an API key, send a first request with curl and create a site through the Kukie.io API. Includes the steps to import the OpenAPI document into Postman or Bruno. (Agency plan)
  2. API keys and permissions An API key belongs to your organisation and can do only what you choose. Learn who can create one, what each permission allows, when a key expires, and how to roll or revoke it. (Agency plan)
  3. Handle API errors An error of the Kukie.io API has one JSON shape and a stable code. See what each member means, the list of codes, and which errors to retry. (Agency plan)
  4. API rate limits The limits for each API key and organisation, the limits single operations add, the headers that report them, and what to do when the API answers 429. (Agency plan)
  5. Retry requests with an idempotency key Send an Idempotency-Key header with a POST request, so that a retry after a timeout gets the first answer back while it is stored. Learn what is stored, for how long, and what each answer means. (Agency plan)
  6. Read lists page by page Lists in the Kukie.io API come in pages. Set the page size with limit, follow next_cursor to the last page, and learn what a cursor is tied to. (Agency plan)
  7. API versions and changes What can be added to version 1 of the Kukie.io API at any time, how to write software that keeps working, and how a breaking change is announced. (Agency plan)
  8. Receive webhooks Kukie.io can send your server a signed message when a scan ends or a site is created, verified or deleted. Create an endpoint, verify signatures, and handle retries and duplicates. (Agency plan)

Listed on