Возвращает список мультимедиа-файлов, связанных с произведением. Актуально для типов контента 1 и 4.

ID функции

r_art_files

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

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

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

art* – ID запрашиваемой книги (целое положительное число).

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

group* – массив объектов, содержащий информацию обо всех мультимедиа-файлах, связанных с запрашиваемым ID книги. Файлы разбиты на группы по типу кодирования:

• value – тип кодирования, относящийся к одной группе файлов. Возможные значения:

для контента с типом 1 (аудиокниги):

• • 1 – ознакомительный фрагмент. MP3, 128 Kbps;
  • 2 – копия оригинального диска. MP3-файлы в самораспаковывающемся RAR-архиве;
  • 3 – стандартное качество. MP3, 128 Kbps;
  • 4 – мобильная версия. MP4, 16 Kbps;
  • 5 – стандартное качество. MP3, 192 Kbps;
  • 6 – мобильная версия. MP4, 32 Kbps;
  • 7 – стандартное качество. MP3, 64 Kbps;
  • 8 – дополнительные материалы;
  • 19 – мобильная версия. MP4, 64 Kbps;
  • 20 – MP3 файлы в zip архиве;

для контента с типом 4 (PDF):

• • 9 – ознакомительный фрагмент pdf;
  • 10 – PDF-книга;
  • 11 – обложка в PDF (PoD);
  • 15 – дополнительные материалы;
• files – массив с файлами, по каждому содержит подробное описание файла. Включает:
  • id – численный ID файла;
  • release_date – дата релиза файла аудио черновика (для контента с типом 1 и exp_chars) в ISO-виде «YYYY-MM-DD», например, «1999-12-21». Значение будет присутствовать в ответе только, если дата релиза меньше либо равна текущей дате;
  • size – размер файла (в байтах);
  • filename – рекомендуемое имя файла;
  • seconds – длительность в секундах (для контента с типом 1);
  • mime_type – тип контента. Возможные значения:
    • audio/mpeg – MP3-файл;
    • audio/m4b – M4B-файл;
    • application/zip – ZIP-файл;
    • application/pdf – PDF-файл.

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

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

{
  "requests": [
    {
      "param": {
        "art": 25761203
      },
      "func": "r_art_files",
      "id": "art_files"
    }
  ],
  "mobile_app": 1,
  "sha": " ",
  "time": "2020-02-12T15:10:21+03:00",
  "sid": " "
}

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

{
  "art_files": {
    "group": [
      {
        "files": [
          {
            "filename": "20.mp3",
            "id": 30126531,
            "mime_type": "audio/mpeg",
            "seconds": 558,
            "size": 1977710
          }
        ],
        "value": "1"
      },
      {
        "files": [
          {
            "filename": "21.mp3",
            "id": 30126530,
            "mime_type": "audio/mpeg",
            "seconds": 279,
            "size": 1977710
          },
          {
            "filename": "22.mp3",
            "id": 30126529,
            "mime_type": "audio/mpeg",
            "seconds": 279,
            "size": 1977710
          },
          {
            "filename": "23.mp3",
            "id": 30126541,
            "mime_type": "audio/mpeg",
            "release_date": "2020-02-09",
            "seconds": 1,
            "size": 1977710
          },
          {
            "filename": "24.mp3",
            "id": 30126542,
            "mime_type": "audio/mpeg",
            "release_date": "2020-02-10",
            "seconds": 1,
            "size": 1977710
          }
        ],
        "value": "5"
      }
    ],
    "success": true
  },
  "success": true,
  "time": "2020-02-12T15:10:28+03:00"
}