Інше

Те, що варто знати до першої інтеграції.

Три форми пагінації

  • total + items[] — каталог, персонажі, чарти, роботи студій.
  • count + results[] + next як посилання — довідники студій.
  • Добірки та теги повертають голий масив без обгортки.

Ліміт запитів

40 запитів за хвилину на IP. Перевищення — 429 із заголовком Retry-After.

Потрібно більше — звʼяжіться з нами.

Коди відповіді

200

Успіх. Тіло — JSON у UTF-8.

404

Обʼєкта з таким ID або slug немає.

405

Метод не GET.

422

Параметр не пройшов валідацію. Тіло містить detail[] із вказівкою на поле.

429

Перевищено ліміт. Заголовок Retry-After каже, коли пробувати знову.

Ідентифікатори

Ключ скрізь — числовий id. Адреси сайту мають вигляд /anime/<slug>-<id>, тож ID можна взяти з хвоста посилання. Пошук за slug — непрямо, через /anime?search=. Виняток — новини: там ключем є slug.

Кеш і шляхи

Списки кешуються на 60 секунд, картки — на 5 хвилин. Шлях у таблицях канонічний: варіант із зайвою або відсутньою скісною рискою відповість 307.

Потрібен ендпоінт, якого тут немає — напишіть у підтримку.