Довідник API

Ліміти запитів (Rate Limits)

Кожна відповідь містить наступні заголовки, які допомагають відстежувати та дотримуватися лімітів запитів:

Заголовок	Опис
x-rate-limit-limit	Тривалість поточного вікна ліміту запитів (наприклад 1m)
x-rate-limit-remaining	Залишок запитів у поточному вікні
x-rate-limit-reset	Штамп часу ISO 8601, коли поточне вікно скидається

Ліміти

Ендпоінт	Ліміт
/search	7 запитів за 5 секунд
/:category	200 запитів на хвилину (на категорію)

User-Agent

Усі запити повинні містити заголовок User-Agent. Будь ласка, використовуйте наступний формат: НАЗВА_ДОДАТКУ (КОНТАКТНА_ІНФОРМАЦІЯ).
Наприклад: NekoApp (https://example.com) або NekoApp (dev@example.com)

Рекомендації щодо назви:

• Будьте конкретними: Не використовуйте загальні назви, такі як "Discord Bot", "WhatsApp Bot" або "Telegram Bot". Ваш додаток повинен мати унікальну назву.
• Уникайте шаблонів: Не використовуйте значення на зразок test, bot або приклад вище.
• Ніяких стандартних значень бібліотек: Уникайте використання стандартних рядків бібліотек, таких як python-requests, okhttp, axios, node або Go-http-client.

Варіанти контактної інформації:
Контактна інформація не обов'язково має бути традиційним вебсайтом. Будь-який з наступних варіантів є прийнятним способом ідентифікації:

• Пряма контактна адреса електронної пошти.
• Вебсайт проєкту або публічний URL репозиторію (наприклад, GitHub, GitLab).
• Посилання для запрошення бота або сторінка опису.
• URL-адреса у каталогах (наприклад, top.gg або аналогічних).

Підробка та видавання себе за інших:

• Не підробляйте рядки браузера. Формат Mozilla/5.0 ... суворо зарезервований для реальних веббраузерів та перевірених ботів Cloudflare.
• Не видавайте себе за відомих пошукових роботів, таких як Googlebot або Bingbot.

Недотримання цих правил та використання загальних, стандартних або підроблених значень, найімовірніше, призведе до блокування ваших запитів.

Категорії

Категорії визначають тип контенту, що повертається API. Кожна категорія відповідає фіксованому формату файлу.

Зображення

husbandokitsunenekowaifu

GIF

angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet

Поля відповідей

Тип	Поля
Зображення	artist_name, artist_href, source_url
GIF	anime_name

url та dimensions включені в обидва типи.