Документация

Устройство ленты, API публикации и то, как переехать, не потеряв подписчиков.

Перенос шоу

Дайте ссылку на текущую ленту. Мы копируем все файлы, переписываем ссылки и выдаём запись для редиректа на старом хостинге, чтобы подписчики перешли сами.

bash

fonoteka import --feed https://old-host.example/feed.xml \
  --show 'Долгая дорога' --keep-guids

# 312 выпусков · 41,2 ГБ · готово за 6 мин 14 с

Не убирайте --keep-guids, если не хотите, чтобы у всех подписчиков приложения перекачали весь архив заново. Мы видели переезд, породивший 40 ТБ бессмысленного трафика из-за смены идентификаторов.

Устройство ленты

Отдаём RSS 2.0 с пространствами имён iTunes и Podcasting 2.0. Всё генерируется само, но любое поле можно переопределить.

json

{
  "title": "142 — Последняя телефонистка",
  "guid": "fn_9c31f0a2",
  "enclosure": {
    "url": "https://cdn.rdfyf.nowavpn.pro/e/fn_9c31f0a2.mp3",
    "length": 86114304,
    "type": "audio/mpeg"
  },
  "duration": 5642,
  "transcript": "https://cdn.rdfyf.nowavpn.pro/t/fn_9c31f0a2.vtt"
}

Авторизация

Токены на шоу или на весь аккаунт. Токен для статистики можно сделать только на чтение и с ограниченным сроком — так выдают доступ рекламодателю.

Выпуски

Метод	Путь	Назначение
`GET`	`/v1/shows/{id}/episodes`	список с курсором
`POST`	`/v1/shows/{id}/episodes`	создать, вернёт ссылку для загрузки
`PATCH`	`/v1/episodes/{id}`	изменить метаданные или расписание
`POST`	`/v1/episodes/{id}/publish`	опубликовать сейчас или по времени
`DELETE`	`/v1/episodes/{id}`	снять с публикации

Выгрузка статистики

Ежедневная выгрузка CSV в ваше объектное хранилище или запрос напрямую. Строки становятся неизменяемыми через 48 часов — это окно на коррекции.