sithond.com

Запрос авторизованного доступа к API. После одобрения администратором вы получите Bearer-токен для Authorization-заголовка без ограничений по частоте запросов.

Тело запроса (JSON)

{"name":"Иван","email":"ivan@example.com","use_case":"Хочу показывать список аниме на своём сайте"}

Пример ответа

{"ok":true}

Публичная информация об авторе сайта.

Пример ответа

{"name":"Ivan","role":"Developer","bio":"...","avatar":"https://...","email":"","social":{"github":"https://github.com/user"},"theme":{}}

Список опубликованных проектов.

Query параметры

limit	число или "all"
offset	смещение
tag	фильтр по тегу
q	поиск

Пример ответа

[{"id":1,"slug":"my-project","name":"My Project","tags":["go"],"views":42,"published":true}]

Один проект по slug или числовому id.

Пример ответа

{"id":1,"slug":"my-project","name":"My Project",...}

Список опубликованных новостей.

Query параметры

limit	число или "all"
offset	смещение
tag	фильтр по тегу
q	поиск
project_id	фильтр по проекту

Пример ответа

[{"id":1,"slug":"my-post","title":"My Post","views":10,"tags":["авто"],"published":true}]

Одна новость по slug или числовому id.

Пример ответа

{"id":1,...}

Список опубликованных страниц.

Query параметры

show_in_nav

true — только страницы в навигации

Пример ответа

[{"id":1,"slug":"about","title":"О проекте","show_in_nav":true,"published":true}]

Одна страница.

Пример ответа

{"id":1,...}

Одобренные комментарии.

Query параметры

target_type	"post" или "project"
target_slug	slug записи

Пример ответа

[{"id":1,"author":"Alice","content":"Отлично!","approved":true}]

Оставить комментарий.

Тело запроса (JSON)

{"target_type":"post","target_slug":"my-post","author":"Alice","content":"Отлично!"}

Пример ответа

{"ok":true}

Форма обратной связи. Лимит: 1 раз в 5 минут.

Тело запроса (JSON)

{"name":"Alice","email":"alice@example.com","message":"Привет!"}

Пример ответа

{"ok":true}

Засчитать просмотр. Дедупликация по IP — 1 раз в сутки.

Тело запроса (JSON)

{"type":"post","slug":"my-post"}

Пример ответа

{"counted":true,"count":43}

Загруженный медиафайл. Кеш 1 год.

RSS-лента последних 20 новостей.

Sitemap для поисковиков.

Проверка доступности API.

Пример ответа

{"ok":true,"service":"shikirip-api"}

Отправить жалобу со страницы аниме или манги. Лимит — общий рейт-лимит API. Уведомление уходит в Telegram.

Тело запроса (JSON)

{"type":"anime","target_id":"21","category":"broken_link","description":"Серия 5 не открывается","video_id":42}

Пример ответа

{"id":1,"type":"anime","target_id":"21","category":"broken_link","status":"pending","created_at":"..."}

(Админ) Список заблокированных аниме/манги.

Query параметры

type	"anime" или "manga"

Пример ответа

{"items":[{"id":1,"type":"anime","target_id":"21","reason":"по требованию правообладателя"}],"total":1}

(Админ) Добавить ограничение. Запросы на /v1/anime/:id/videos и /api/shikivideos/:id вернут пустой массив или 403.

Тело запроса (JSON)

{"type":"anime","target_id":"21","reason":"по требованию правообладателя"}

Пример ответа

{"id":1,...}

(Админ) Снять ограничение.

Пример ответа

{"ok":true,"id":1}

(Админ) Видео помеченные как мёртвые.

Query параметры

confirmed	"true" — только подтверждённые, "false" — только не подтверждённые
limit	лимит
offset	смещение

Пример ответа

{"items":[{"id":42,"url":"https://...","is_dead":true,"dead_confirmed":false}],"total":1}

(Админ) Вручную пометить ссылку как мёртвую. confirm:true — подтвердить (видео перестаёт отдаваться API).

Тело запроса (JSON)

{"is_dead":true,"confirm":true}

Пример ответа

{"id":42,"dead_confirmed":true,...}

(Админ) Проверить доступность ссылки HEAD-запросом. Обновляет is_dead, dead_http_status.

Пример ответа

{"id":42,"is_available":false,"checked_http_status":404,...}

Поиск видеоссылок. Поле provider: "shikirip" | "smarthard".

Query параметры

anime_id	ID аниме (псевдонимы: animeId, target_id, targetId)
uploader	фильтр по нику
q	поиск по тексту
limit	лимит (по умолчанию 100)
offset	смещение

Пример ответа

[{"id":1,"url":"https://...","anime_id":21,"episode":1,"kind":"tv","language":"ru","quality":"1080p","author":"Anilibria","hosting":"kodik.info","provider":"shikirip"}]

Все видеоссылки для аниме. Мержит локальную БД + Smarthard (при наличии токена).

Query параметры

limit	лимит
offset	смещение
uploader	фильтр

Пример ответа

[...]

Число уникальных эпизодов с видео.

Пример ответа

{"length":130}

Общее число загрузок или загрузок пользователя.

Query параметры

uploader

ник (необязательно)

Пример ответа

{"count":1842}

Унифицированный список видео из всех источников. Каждый объект содержит поле provider: "shikirip" | "smarthard" | "kodik".

Query параметры

providers	comma-list: shikirip,smarthard,kodik или all (по умолчанию: shikirip,smarthard)
episode	фильтр по номеру эпизода
language	фильтр по языку (ru, en, …)
limit	лимит (по умолчанию все)
offset	смещение

Пример ответа

{"items":[{"id":1,"url":"https://...","anime_id":21,"episode":1,"kind":"tv","language":"ru","quality":"1080p","author":"AnilibriA","hosting":"kodik.info","provider":"kodik","watches_count":0}],"total":1,"offset":0,"limit":1}

Число уникальных эпизодов (локальная БД + Smarthard при наличии токена).

Пример ответа

{"count":130}

Добавить видеоссылку. Требует Bearer-токен. Тот же формат, что и POST /api/shikivideos.

Тело запроса (JSON)

{"url":"https://...","anime_id":21,"episode":1,"kind":"tv","language":"ru","quality":"1080p","author":"AnilibriA","hosting":"kodik.info"}

Пример ответа

{"id":42,...}

Удалить видеоссылку. Требует Bearer-токен.

Пример ответа

{"ok":true,"id":42}

Рейтинги озвучек по аниме. user_vote заполнен при авторизации.

Query параметры

anime_id

ID аниме (обязательно)

Пример ответа

[{"author":"AnilibriA","up":5,"down":1,"user_vote":1}]

Проголосовать за озвучку. Требует Bearer-токен.

Тело запроса (JSON)

{"anime_id":21,"author":"AnilibriA","vote":1}

Пример ответа

{"ok":true}

Отозвать голос. Требует Bearer-токен.

Query параметры

anime_id	ID аниме
author	название озвучки

Пример ответа

{"ok":true}

Список источников манги из комьюнити-каталога.

Query параметры

shikimori_id	ID манги на Shikimori
source	фильтр: mangalib | readmanga | remanga
limit	лимит
offset	смещение

Пример ответа

{"items":[{"id":1,"source":"mangalib","slug":"21--berserk","name":"Берсерк","cover_url":"https://...","shikimori_id":"2966"}],"total":1}

Добавить источник манги. Требует Bearer-токен.

Тело запроса (JSON)

{"source":"mangalib","slug":"21--berserk","name":"Берсерк","cover_url":"...","added_by":"user","shikimori_id":"2966"}

Пример ответа

{"id":1,...}