Created by Мария Фёдорова, last modified by Светлана Казакова on мая 28, 2024

С помощью этого запроса можно получить информацию о входящих в подкаст выпусках.

ID функции

r_browse_podcast

Кто может вызывать

Любой пользователь
Авторизованное приложение

Принимаемые параметры

id* – идентификатор подкаста, информацию о выпусках которого необходимо получить;

limit – ограничение на количество возвращаемых артов. Работает аналогично инструкции limit в MySQL и в запросе представлен одним числом либо массивом из двух чисел «N,M». Если limit указан, возвращается M книг, начиная с книги N (у первой книги номер 0). Если limit не задан – значение по умолчанию «0, 20»;

sort – порядок, в котором следует сортировать выпуски подкастов. Возможные значения:

  • pop – сортировка по популярности ;
  • new – сортировка по новизне (от последних вышедших к первым);
  • default – по порядку (от первого вышедшего выпуска к последнему).

anno – если параметр передан и имеет значение «1», то в ответе к найденным артам будут добавлены аннотации (см. annotation);
currency – валюта, в которой необходимо возвращать цены и цены InApp'ов на арты. Если параметр не передан, информация по InApp'ам (inapp_price, inapp_name) не возвращается. Допустимые значения:

  • RUB – российские рубли (по умолчанию);
  • USD – доллары США;
  • EUR – евро;
  • PLN – польские злотые.

Возвращаемые значения

podcasts* – массив, содержащий информацию о выпусках запрошенного подкаста. Каждый выпуск содержит:

  • id* – ID выпуска подкаста;
  • title* – название выпуска подкаста;
  • annotation – строка с фрагментом описания к книге в формате аннотации к FB3-книге: fb3-description/annotation (абзацы p, пустые строки br, ссылки a, форматирование текста жирным strong и курсивным em начертанием). Данное описание присутствует в ответе только, если в запросе был передан параметр anno, и в базе в принципе есть описания к этому выпуску;
  • mark_1* – общее кол-во пользователей, оценивших данную книгу на «1»;
  • mark_2* – общее кол-во пользователей, оценивших данную книгу на «2»;
  • mark_3* – общее кол-во пользователей, оценивших данную книгу на «3»;
  • mark_4* – общее кол-во пользователей, оценивших данную книгу на «4»;
  • mark_5* – общее кол-во пользователей, оценивших данную книгу на «5»;
  • available_date* – дата поступления подкаста в продажу;
  • podcast_serial_number* – номер выпуска в подкасте;
  • chars – длительность выпуска подкаста в секундах;
  • my ­– признак того, что этот выпуск уже куплен/получен этим пользователем:
    • 1 – эта книга уже есть у пользователя (куплена, получена, доступна для скачивания);
  • free – признак бесплатного выпуска (если «1» – выпуск доступен бесплатно);
  • base_price* – базовая цена выпуска в рублях;
  • final_price* – итоговая цена выпуска в рублях с учётом активных скидок («магия», определяющая какую часть покупки можно оплатить бонусами и пр. здесь не учитывается);
  • inapp_base_price – цена базового (до применения скидок) InnApp'а в запрошенной валюте (см. currency в запросе);
  • inapp_price – итоговая цена InnApp'а в запрошенной валюте (см. currency в запросе);
  • inapp_name – название итогового InnApp'а;
  • date_written – дата записи;

podcast_info* – дополнительная информация о подкасте. Включает в себя:

  • cnt* – количество выпусков (числом);
  • left_to_buy – количество выпусков, которые текущий юзер может купить (числом);
  • podcast_complete – информация о завершенности подкаста. Имеет значение 1, возвращаемое только в случае завершенности. Если подкаст продолжается, параметр не вовзращается. Число;
  • base_price* – базовая цена (суммарная) всех выпусков подкаста в запрошенной валюте (см. currency в запросе);
  • final_price* – итоговая цена (суммарная) всех выпусков подкаста в запрошенной валюте с учётом активных скидок («магия», определяющая какую часть покупки можно оплатить бонусами и пр. здесь не учитывается);
  • inapp_base_price – базовая цена InApp'а в запрошенной валюте (см. currency в запросе), отсутствует, если final_price = 0;
  • inapp_price – цена InApp'а в запрошенной валюте (см. currency в запросе), отсутствует, если final_price = 0;
  • inapp_name – название InApp'а, отсутствует, если final_price = 0;
  • date_written – дата записи последнего выпуска текущего подкаста;

arts_issues – информация об артах, не вошедших в расчет InApp'а на подкаст, и причинах, из-за которых они не вошли:

  • id – ID книги:
  • error_code – код ошибки.

Если не было найдено ни одного подкаста с запрошенным ID, то массив podcats будет пустым.

Возможные ошибки

error_code

error_message

Описание

101098

ERROR_ART_NOT_AVAILABLE

Арт не доступен для продажи










Пример запроса на сервер

{
   "app": "1",
   "time": "2020-11-07T16:21:02+03:00",
   "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
   "sid": "7bad5f2fb752ee957a4ab74aaac7711g",
   "requests": [
           {
                 "func": "r_browse_podcast",
                 "id": "browse_podcast",
                 "param": {
                   "id": "57426554",
                   "limit": ["0","3"],
                   "sort": "default",       
                   "currency": "RUB"
                 }
           }
   ]
}

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

{
  "success": true,
  "time": "2020-11-07T16:21:02+03:00",
  "browse_podcast" : {
    "success" : true,
    "podcasts" : [
        {
          "id": "29798333",
          "name": "Актер кино Артур Сопеньник",
          "annotation": "Тут должно быть какое-то описание, если оно заполнено в базе",
          "mark_1" : "2",
          "mark_2" : "12",
          "mark_3" : "10",
          "mark_4" : "33",
          "mark_5" : "23",
          "available_date" : "2020-02-01T06:27:05+03:00",
          "serial_number": "1",
          "base_price" : "49",
          "final_price" : "29",
          "inapp_base_price " : "75",
          "inapp_price " : "29",
          "inapp_name" : "ru.litres.app.refill_99.XXL"
        },
        {
          "id": "29798365",
          "name": "Режиссеры и сценаристы Наталья Меркулова и Алексей Чупов",
          "annotation": "Тут должно быть какое-то описание, если оно заполнено в базе",
          "mark_1" : "2",
          "mark_2" : "1",
          "mark_3" : "1",
          "mark_4" : "3",
          "mark_5" : "2",
          "available_date" : "2020-02-01T06:27:05+03:00",
          "serial_number": "2",
          "base_price" : "49",
          "final_price" : "29",
          "inapp_base_price " : "75",
          "inapp_price " : "29",
          "inapp_name" : "ru.litres.app.refill_99.XXL"
        },
        {
          "id": "29798389",
          "name": "Актер и телеведущий Сергей Писаренко",
          "annotation": "Тут должно быть какое-то описание, если оно заполнено в базе",
          "mark_1" : "0",
          "mark_2" : "2",
          "mark_3" : "10",
          "mark_4" : "3",
          "mark_5" : "2",
          "available_date" : "2020-02-01T06:27:05+03:00",
          "serial_number": "3",
          "base_price" : "49",
          "final_price" : "29",
          "inapp_base_price " : "75",
          "inapp_price " : "29",
          "inapp_name" : "ru.litres.app.refill_99.XXL"
        }
    ]
  }
}