Документація Initask API

REST API з відповідями у JSON. Базова адреса https://dani.initask.com, усі ендпоінти приймають GET. Машиночитний опис: OpenAPI 3.1, його читають Postman, Insomnia і генератори клієнтів.

Авторизація

Ключ передається заголовком Authorization: Bearer КЛЮЧ або параметром ?key=КЛЮЧ. Без ключа доступно 100 запитів на добу з однієї IP-адреси. Ключ з тарифом «Старт» дає 10 000 запитів на місяць, «Про» 100 000. Ключ приходить листом після реєстрації на сторінці цін.

curl -H "Authorization: Bearer $INITASK_KEY" "https://dani.initask.com/v1/usage"

/v1/usage показує тариф, ліміт і залишок і в ліміт не йде. Та сама статистика по днях і ендпоінтах є у кабінеті.

Ліміти

Добовий ліміт скидається опівночі за Києвом, місячний першого числа. Кожна відповідь несе заголовки X-RateLimit-Limit, X-RateLimit-Remaining і X-RateLimit-Reset (Unix-час скидання). Після вичерпання приходить 429 із заголовком Retry-After у секундах. Окремо діє межа 20 запитів за секунду.

Формат відповіді

{
  "ok": true,
  "data": {
    "...": "..."
  },
  "meta": {
    "source": "reestr.initask.com",
    "cached": false
  }
}

meta.source називає джерело, meta.cached каже, чи відповідь узято з кешу шлюзу. Відповіді з ключем мають Cache-Control: no-store. Для браузера відкрито CORS на GET з будь-якого домену.

Помилки

Ендпоінти