Список всех последних изменений текстов за сутки
Функция: Возвращает список событий по всем отслеживаемым авторам и их текстам за последние сутки.
Адрес:
https://siwatcher.ru/api?app_id=your-application-id&debug=0
Сжатие ответа: GZIP
Кодировка: UTF-8
Идентификатор приложения: Обязателен
Идентификатор пользователя: Не требуется
Вывод в режиме отладки: Предусмотрен
Формат ответа:JSON
{"response":[
{
"event":"605426",
"time":"1489001101",
"url":"g\/goncharowa_g_d\/1morskiekorolidorogisudeb.shtml",
"type":"1",
"rating":"8.02*57",
"author":"Имя автора",
"site":"1",
"utype":"2",
"title":"Название текста",
"genre":"жанр, жанр2, жанр3",
"description":"Аннотация",
"size":"78",
"oldsize":"78"
},
{
"event":"605425",
"time":"1489001101",
"url":"g\/goncharowa_g_d",
"type":"2",
"rating":"6.31*1151",
"author":"Имя автора",
"site":"1",
"utype":"6",
"texts":"g\/goncharowa_g_d\/elkaieedruzxja.shtml g\/goncharowa_g_d\/protiwlomanetwampira-obshijfajl.shtml ...",
"description":"Обновление на странице 'Гончарова Галина Дмитриевна' (id=64229, http://samlib.ru/g/goncharowa_g_d ):
Добавлено новое произведение Морские короли - обновление (35КБ ) Фэнтези [id=229200 http://samlib.ru/g/goncharowa_g_d/morskiekoroli-obnowlenie.shtml ]
"
}, ...
]}
Описание полей:
Предусмотрен вывод с разным содержимом полей для событий по текстам и по авторам. Для изменений текстов набор полей ниже:
- event - уникальный номер события
- time - время выдачи события
- url - относительная ссылка на текст
- type - равен 1 для событий по изменению текстов у автора и равен 2 для событий изменений на странице автора
- rating - рейтинг текста в формате х.хх*х, где после * - число голосов
- author - имя автора
- site - код сайта, на котором находится текст
- utype - тип определённого изменения
- title - название текста
- genre - список жанров через запятую (максимум три)
- description - аннотация автора к тексту
- size - текущий размер текста в килобайтах, округлённый до целого
- oldsize - предыдущий размер текста до текущего изменения текста
Для изменений на странице автора выводится следующий набор полей:
- event - уникальный номер события
- time - время выдачи события
- url - относительная ссылка на страницу автора
- type - равен 2 для событий изменений на странице автора
- rating - рейтинг автора в формате х.хх*х, где после * - число голосов
- author - имя автора
- site - код сайта, на котором находится текст
- utype - тип определённого изменения
- texts - строка списка всех текстов автора на странице в виде относительных ссылок через пробел
- description - содержимое изменения на странице автора в подготовленном читабельном виде
Поле site может принимать следующие значения:
- 1 - сайт Самиздат (samlib.ru)
- 2 - оповещение относится к подборкам SIwatcher
- 3 - сайт Author.today
Поле utype может принимать следующие значения:
- 1 - изменился размер книги
- 2 - изменилась аннотация
- 3 - изменился жанр
- 4 - изменилось название текста
- 5 - изменилось имя автора
- 6 - добавлен новый текст (общий признак, если не известен более точный)
- 7 - удалён текст (общий признак, если не известен более точный)
- 20 - создание книги автором
- 21 - первая публикация книги
- 22 - автор убрал книгу в черновик
- 23 - автор опубликовал книгу из черновика
- 24 - автор удалил книгу
- 25 - книга помечена как "завершенная"
- 26 - книга помечена как "в процессе"
- 30 - начала действовать скидка
- 31 - закончилось действие скидки
- 32 - размер скидки изменен
- 35 - изменена цена книги
- 36 - изменена цена главы книги
- 37 - рекомендация администрации ресурса
- 40 - добавлена новая часть
- 41 - часть была отредактирована (изменение текста)
- 42 - глава была убрана в черновик
- 43 - глава была опубликована из черновика
- 44 - глава была удалена
- 45 - глава была отредактирована
- 101 - модератор убрал книгу из общего доступа
- 102 - модератор удалил книгу
- 103 - модератор вернул книгу в общий доступ
Обратите внимание - любой запрос должен сопровождаться параметром app_id! Если его не будет, функция вернёт в заголовке код 403.
Для отладки предусмотрен параметр debug. Если он равен 1, то результат функции будет выведен не в формате JSON, а в читаемом виде. В обычном режиме работы использование данного параметра не обязательно.