Доступ и запросы
Без ключа, только чтение, на стороне сервера; форматы идентификаторов, дат и отсутствующих значений.
Без ключа и регистрации
Публичному API не нужны ключ API, токен или учётная запись. Каждая операция в этой документации — анонимный GET-запрос: отправьте его и прочитайте JSON.
curl "https://api.nogitsu.com/v1/works?limit=3"Только публичные данные
API отдаёт то, что любой может и так увидеть на nogitsu.com. Учётные записи, библиотеки, закрытые разделы профилей, модерация и все операции записи не входят в публичный API и здесь не описаны.
Вызывайте API со своего сервера
Веб-страницы других сайтов не могут вызывать API из браузера: кросс-доменные запросы разрешены только с nogitsu.com. Отправляйте запросы со своего сервера, из скрипта или на этапе сборки и сохраняйте копию ответов.
Назовите своё приложение
Отправляйте заголовок User-Agent с названием вашего приложения, например my-app/1.0. Наша сетевая защита блокирует некоторые стандартные агенты библиотек, например тот, что отправляет urllib в Python, и возвращает страницу 403, которая не является JSON.
curl -A "my-app/1.0 (+https://example.com)" "https://api.nogitsu.com/v1/genres"Идентификаторы, даты и отсутствующие значения
Ответы — это JSON в кодировке UTF-8. Идентификаторы — UUID. Даты записываются как ГГГГ-ММ-ДД, а моменты времени — как метки времени ISO 8601 в UTC. Неизвестное значение — это null; оно никогда не заменяется на 0 или пустой текст.
{
"id": "01a0cac5-388a-75ed-a3a6-4a5d2db4261e",
"startDate": "2018-03-04",
"season": null,
"seasonYear": null
}