Shikimori API

Здравствуйте,

Я обращаюсь к вам с предложением по улучшению API, которое, на мой взгляд, значительно упростит работу разработчиков и сделает ваш сервис еще более удобным для использования.

Суть предложения:

1. Сортировка по updated_at: Добавьте возможность сортировки по полю updated_at для всех версий и категорий API (аниме, манга и т.д.). Это позволит разработчикам отслеживать изменения в базе данных и получать только обновленные данные.
2. Поле created_at: Добавьте поле created_at в API v1 для общего списка и информации по отдельным аниме, аналогично полю updated_at. Это даст возможность отслеживать не только обновления, но и новые поступления (да я понимаю что id для этого тоже годится, но работать с датами будет более правильно я считаю).
3. Синхронизация полей с GraphQL:
- Добавьте в обычный API все поля, присутствующие в GraphQL (например, isCensored).
- Приведите названия полей в API и GraphQL к единому стандарту (например, используйте aired_on вместо airedOn, как более старый и классический нейминг).

Обоснование:

Ваша база данных является стандартом для многих русскоязычных ресурсов, и предоставление удобного API — это вклад в развитие аниме-сообщества.

Реализация предложенных изменений принесет следующие выгоды:

1. Эффективность: Разработчики смогут оптимизировать свои скрипты, получая только новые или измененные релизы.
2. Снижение нагрузки: Парсинг только обновленных данных снизит нагрузку на API, так как не потребуется загружать всю базу данных для поиска изменений.
3. Устранение костылей: Разработчикам не придется использовать сложные обходные пути (например, получение дат обновления через GraphQL списком), чтобы получить необходимую информацию.
4. Полнота данных: API станет более полным и информативным.
5. Унификация: Единые названия полей в разных версиях API сделают интеграцию данных более простой и прозрачной, уменьшив количество ошибок и упростив отладку.

Заключение:

Надеюсь, вы рассмотрите мое предложение. Я понимаю, что реализация может занять время, но уверена, что эти изменения будут выгодны всем. Даже если вы решите не внедрять эти изменения, буду благодарна за обратную связь о возможности их реализации в будущем.

С уважением, DIna Moon.