API Nogitsu
Бесплатный JSON API только для чтения ко всему, что на Nogitsu открыто публично: каталог аниме и манги, персонажи, люди и компании, новости, трейлеры, расписание выхода, рецензии, сообщества и публичные списки участников.
- Базовый адрес
- https://api.nogitsu.com
Ваш первый запрос
Каждая операция — это обычный GET-запрос. Не нужно создавать ключ или что-либо подписывать. Этот запрос возвращает три самых популярных произведения:
curl "https://api.nogitsu.com/v1/works?limit=3"Ответ приходит в JSON. Списки помещают результаты в items, а адрес следующей страницы — в nextCursor:
{
"items": [
{
"id": "01a0cac5-388a-75ed-a3a6-4a5d2db4261e",
"slug": "solo-leveling",
"medium": "manhwa",
"primaryTitle": "Solo Leveling",
"aggregateScore": 850,
"popularityRank": 1
},
{
"id": "01a0cb02-0a14-7877-911d-5b4dde76df72",
"slug": "attack-on-titan",
"medium": "anime",
"primaryTitle": "Attack on Titan",
"aggregateScore": 847,
"popularityRank": 1
},
{
"id": "01a0cb0a-37c1-7946-be38-bfc9f1a5af0e",
"slug": "berserk",
"medium": "manga",
"primaryTitle": "Berserk",
"aggregateScore": 908,
"popularityRank": 1
}
],
"nextCursor": "eyJ2YWx1ZSI6MSwiaWQiOiIwMWEwY2IwYS0zN2MxLTc5NDYtYmUzOC1iZmM5ZjFhNWFmMGUifQ"
}Что нужно знать сначала
- Без ключа, токена и регистрации.
- Только чтение: только то, что открыто на nogitsu.com.
- Вызывайте API со своего сервера; браузеры на других сайтах блокируются.
- 120 запросов в минуту с каждого адреса.
- Бесплатно для некоммерческого использования с указанием Nogitsu.
Руководства
- Доступ и запросыБез ключа, только чтение, на стороне сервера; форматы идентификаторов, дат и отсутствующих значений.
- Страницы и курсорыКак операции получения списков делят результаты на страницы и как прочитать следующую.
- ОшибкиЕдиный формат ошибок, коды состояния и что делать в каждом случае.
- Ограничения частоты и кэшированиеСколько запросов можно отправлять, какие заголовки об этом сообщают и что кэшировать.
- ЯзыкиКак получить описания и подписи на одном из двенадцати языков сайта.
- ИзображенияОбложки, баннеры и портреты: размеры, уменьшенные копии в AVIF и права.
- Лицензия и указание авторстваЧто можно делать с данными, как указывать Nogitsu и что не входит в открытые данные.
Операции по темам
- Произведения6 операцийКаталог аниме, дунхуа, анимации, манги, манхвы, маньхуа и вебтунов: списки с фильтрами, отдельные произведения и словарь жанров.
- Подробности о произведении10 операцийВсё, что есть на странице произведения помимо сводки: серии и главы, персонажи, создатели, связанные произведения, трейлеры, изображения, где смотреть или читать, и статистика участников.
- Поиск4 операцииТекстовый поиск по произведениям и по персонажам, людям и компаниям, а также поиск с фильтрами, на котором работает страница «Обзор».
- Персонажи3 операцииКаталог персонажей и страницы персонажей с произведениями, в которых они появляются.
- Люди4 операцииСэйю, авторы, художники и создатели — с их работами и ролями в озвучке.
- Компании3 операцииСтудии, издатели и другие компании — с произведениями, в которых они указаны.
- Новости3 операцииНовости, составленные по событиям каталога: начало и окончание выхода, даты, возвращение после перерыва, анонсы продолжений и новые трейлеры.
- Трейлеры2 операцииУголок трейлеров: новые, предстоящие, трейлеры этого сезона и популярные, а также отдельные трейлеры.
- Расписание2 операцииСерии с точным временем выхода на ближайшие дни или на диапазон дат.
- Рецензии6 операцийРецензии участников на произведения, сводка рецензий произведения и лучшие рецензенты месяца.
- Сообщества8 операцийСообщества форума на каждом языке, сообщество произведения, тренды и количество людей онлайн.
- Посты и комментарии11 операцийПосты форума, деревья комментариев, скрытые спойлеры и ветки комментариев под произведениями, персонажами, людьми, компаниями и рецензиями.
- Списки6 операцийПубличные списки, созданные участниками, и произведения в них.
- Участники13 операцийПубличные профили участников и те их разделы, которые каждый участник решил показывать.