API подкастов Панели Управления Интернет-радио

Endpoint: /api/v2/podcasts/
HTTP метод: GET
Авторизация: не требуется
Параметры:
limit: количество записей в ответе (опционально)
offset: смещение, указывает начальную запись (опционально)
server: ID радиосервера (опционально)

Возвращает список подкастов.

Пример

import requests

response = requests.get("https://demoaccount.s02.radio-tochka.com:8080/api/v2/podcasts/?server=1")
print(response.json())

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

[
    {
        "id": 2,
        "folder": "the-retro-podcast",
        "image": "https://radio.com:8080/media/podcast_covers/podcast1.jpg",
        "episodes_count": 5,
        "feed_url": "https://radio.com:8080/api/v2/podcasts/2/feed.xml",
        "public_page_url": "https://radio.com:8080/public/podcasts/2/",
        "title": "The Retro Podcast",
        "description": "There are many variations of passages of Lorem Ipsum",
        "published": true,
        "server": 1
    },
]

Описание

folder: папка подкаста в файловой системе сервера
image: изображение обложки подкаста
episodes_count: количество эпизодов в этом подкасте
feed_url: URL RSS-ленты для этого подкаста
public_page_url: URL публичной страницы этого подкаста, позволяет просматривать подкаст в браузере
title: название подкаста
description: описание подкаста
published: true, если подкаст опубликован (не черновик)
server: ID радиосервера, к которому относится подкаст

Endpoint: /api/v2/podcasts/
HTTP метод: POST
Авторизация: необходима
Parameters:
title: название подкаста, string
published: boolean - опубликован подкаст или нет
description: описание подкаста, string
server: ID радиосервера

Создает подкаст на радио с указанным ID радиосервера. Если вам также нужно включить обложку подкаста в запрос на создание, отправьте POST-запрос с заголовком multipart/form-data и укажите обложку подкаста через параметр image.

Endpoint: /api/v2/podcasts/id/
HTTP methods: GET
Авторизация: не требуется

Возвращает один подкаст по ID.

Endpoint: /api/v2/podcasts/podcast_id/episodes/
HTTP methods: GET
Авторизация: не требуется

Возвращает список эпизодов подкаста по ID подкаста.

Endpoint: /api/v2/podcasts/podcast_id/episodes/episode_id/
HTTP methods: GET
Авторизация: не требуется

Возвращает эпизод подкаста по ID.

Endpoint: /api/v2/podcasts/podcast_id/episodes/episode_id/episode.mp3/
HTTP methods: GET
Авторизация: не требуется

Скачивает файл эпизода в формате MP3.