MyShows.ru API v1.6

Работа с профилем

Авторизация

http://api.myshows.ru/profile/login?login=<login>&password=<md5(password)>
Пример
http://api.myshows.ru/profile/login?login=demo&password=fe01ce2a7fbac8fafaed7c982a04e229
200 — Аутентификация произведена
403 — Имя пользователя или пароль не подошли
404 — Пустые параметры

Авторизация через Вконтакте

http://api.myshows.ru/profile/login/vk?token=<token>&userId=<userId>
Пример
http://api.myshows.ru/profile/login/vk?token=a8f5f167f44f4964e6c998dee827110c&userId=1
200 — Аутентификация произведена
403 — Не прошла авторизация через соц. сеть
404 — Переданы не все параметры

Авторизация через Facebook

http://api.myshows.ru/profile/login/fb?token=<token>&userId=<userId>
Пример
http://api.myshows.ru/profile/login/vk?token=a8f5f167f44f4964e6c998dee827110c&userId=1
200 — Аутентификация произведена
403 — Не прошла авторизация через соц. сеть
404 — Переданы не все параметры

Авторизация через Twitter

http://api.myshows.ru/profile/login/tw?token=<token>&userId=<userId>&userId=<secret>
Пример
http://api.myshows.ru/profile/login/tw?token=a8f5f167f44f4964e6c998dee827110c&userId=1&secret=5ebe2294ecd0e0f08eab7690d2a6ee69
200 — Аутентификация произведена
403 — Не прошла авторизация через соц. сеть
404 — Переданы не все параметры

Профиль пользователя

http://api.myshows.ru/profile/
Пример
http://api.myshows.ru/profile/
401 — Требуется авторизация
JSON

Список сериалов

http://api.myshows.ru/profile/shows/
Пример
http://api.myshows.ru/profile/shows/
401 — Требуется авторизация
JSON

Список просмотренных серий

http://api.myshows.ru/profile/shows/<show-id>/
Пример
http://api.myshows.ru/profile/shows/1/
401 — Требуется авторизация
404 — Сериал не найден
JSON

Список серий (прошлых, будущих, по сериалу)

http://api.myshows.ru/profile/episodes/unwatched/
http://api.myshows.ru/profile/episodes/next/
Пример
http://api.myshows.ru/profile/episodes/unwatched/
http://api.myshows.ru/profile/episodes/next/
401 — Требуется авторизация
JSON

Отмечание эпизода

http://api.myshows.ru/profile/episodes/check/<episode-id>
optional: rating: 1-5
Пример
http://api.myshows.ru/profile/episodes/check/291461
http://api.myshows.ru/profile/episodes/check/291461?rating=5
401 — Требуется авторизация
200 — ОК

Снятие флага об отмеченном эпизоде

http://api.myshows.ru/profile/episodes/uncheck/<episode-id>
Пример
http://api.myshows.ru/profile/episodes/uncheck/291461
401 — Требуется авторизация
200 — ОК

Синхронизация всех просмотренных эпизодов (полная)

http://api.myshows.ru/profile/shows/<show-id>/sync?episodes=<episode-id>,<episode-id>
Пример
http://api.myshows.ru/profile/shows/142/sync?episodes=16388,16387,16386
401 — Требуется авторизация
404 — Сериал не найден
200 — ОК

Синхронизация всех просмотренных эпизодов (delta)

http://api.myshows.ru/profile/shows/<show-id>/episodes?check=<episode-id>,<episode-id>&uncheck=<episode-id>,<episode-id>
Пример
http://api.myshows.ru/profile/shows/142/episodes?check=16388,16387&uncheck=16386
401 — Требуется авторизация
404 — Сериал не найден
500 — Один из параметров check или uncheck отсутствует
200 — ОК

Управление статусом сериала

http://api.myshows.ru/profile/shows/<show-id>/<status>
status: watching, later, cancelled, remove
Пример
http://api.myshows.ru/profile/shows/1/later
401 — Требуется авторизация
404 — Сериал не найден, неправильные параметры
200 — ОК

Управление рейтингом сериала

http://api.myshows.ru/profile/shows/<show-id>/rate/<rate>
rate: [1-5]
Пример
http://api.myshows.ru/profile/shows/1/rate/5
401 — Требуется авторизация
404 — Сериал не найден, неправильные параметры
200 — ОК

Управление рейтингом эпизода

http://api.myshows.ru/profile/episodes/rate/<rate>/<episode-id>
rate: [1-5]
Пример
http://api.myshows.ru/profile/episodes/rate/5/291461
401 — Требуется авторизация
404 — Эпизод не найден, неправильные параметры
200 — ОК

Управление массовым рейтингом эпизода

http://api.myshows.ru/profile/episodes/rate/?r[<rating>]=<episode-id>,<episode-id>
rating: [1-5]
Пример
http://api.myshows.ru/profile/episodes/rate/?r[5]=291461,291460&r[4]=291462,291463
401 — Требуется авторизация
404 — Эпизод не найден, неправильные параметры
200 — ОК

Список избранных эпизодов

http://api.myshows.ru/profile/episodes/favorites/list/
Пример
http://api.myshows.ru/profile/episodes/favorites/list/
401 — Требуется авторизация
JSON

Управление избранными эпизодами

http://api.myshows.ru/profile/episodes/favorites/<cmd>/<episode-id>
cmd: add, remove
Пример
http://api.myshows.ru/profile/episodes/favorites/add/291461
http://api.myshows.ru/profile/episodes/favorites/remove/291461
401 — Требуется авторизация
404 — Эпизод не найден, неправильные параметры
200 — ОК

Список проигнорированных эпизодов

http://api.myshows.ru/profile/episodes/ignored/list/
Пример
http://api.myshows.ru/profile/episodes/ignored/list/
401 — Требуется авторизация
JSON

Управление проигнорированными эпизодами

http://api.myshows.ru/profile/episodes/ignored/<cmd>/<episode-id>
cmd: add, remove
Пример
http://api.myshows.ru/profile/episodes/ignored/add/291461
http://api.myshows.ru/profile/episodes/ignored/remove/291461
401 — Требуется авторизация
404 — Эпизод не найден, неправильные параметры
200 — ОК

Новости друзей

http://api.myshows.ru/profile/news/
Пример
http://api.myshows.ru/profile/news/
401 — Требуется авторизация
JSON

Поиск сериалов

Поиск

http://api.myshows.ru/shows/search/?q=<query>
Пример
http://api.myshows.ru/shows/search/?q=theory
404 — Ничего не найдено
500 — Параметр q отсутствует JSON

Поиск эпизодов по файлу

http://api.myshows.ru/shows/search/file/?q=<query>
Пример
http://api.myshows.ru/shows/search/file/?q=Star.Wars.The.Clone.Wars.s02e01e02.rus.LostFilm.TV.avi
404 — Ничего не найдено
500 — Параметр q отсутствует JSON

Информация о сериале со списком эпизодов

http://api.myshows.ru/shows/<show-id>
Пример
http://api.myshows.ru/shows/113
404 — Сериал не найден
JSON

Список жанров

http://api.myshows.ru/genres/
Пример
http://api.myshows.ru/genres/
JSON

Рейтинг сериалов

http://api.myshows.ru/shows/top/<gender>/
gender all, male, female
Пример
http://api.myshows.ru/shows/top/all/
404 — Неправильные параметры
JSON

Профиль пользователя

http://api.myshows.ru/profile/<login>
Пример
http://api.myshows.ru/profile/sergeyfast
404 — Пользователь не найден
JSON

PHP Samples

При использовании API не забудьте указать ссылку на myshows.ru :)