RSS-Feeds

Eine Sammlung kann sich selbst als Podcast-Feed anbieten. Wir bauen das XML aus den Dateimetadaten, deshalb stimmen Enclosure-Längen, Dauern und GUIDs immer, und genau daran scheitern die meisten handgeschriebenen Feeds.

Feed aktivieren

curl -X PUT https://api.media-host.online/v1/collections/wochenshow/feed \
  -H "Authorization: Bearer $MH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Die Wochenshow",
    "author": "Mara Lindqvist",
    "owner_email": "feed@wochenshow.example",
    "category": "Society & Culture",
    "explicit": false,
    "artwork_file": "f_Art9Qz",
    "language": "de"
  }'

Der Feed liegt dann unter https://cdn.media-host.online/wochenshow/feed.xml. Er besteht die üblichen Validatoren, trägt podcast:guid und, wenn eine Transkriptdatei angehängt ist, podcast:transcript, und wird bei jeder Änderung in der Sammlung neu erzeugt.

Reihenfolge und Zeitplanung

Folgen sind nach published_at sortiert, neueste zuerst. Eine Datei mit Datum in der Zukunft bleibt bis dahin außen vor: Freitag hochladen, Montag 06:00 live, ohne etwas anzufassen.

Bestehenden Feed umziehen

Nutzen Ihre Abonnenten schon eine Feed-URL unter Ihrer Kontrolle, richten Sie eine dauerhafte Weiterleitung ein und setzen im alten Feed mindestens vier Wochen lang itunes:new-feed-url. Lässt der alte Anbieter keine Weiterleitung zu, halten Sie beide Feeds eine Weile identisch und kündigen den Umzug in einer Folge an. Den Inhalt des alten Feeds erzeugen wir Ihnen zum Einfügen:

mh feed export wochenshow --new-feed-url https://cdn.media-host.online/wochenshow/feed.xml > alter-feed.xml

Eigener Feed

Viele erzeugen den Feed weiter im eigenen CMS und nutzen uns nur für die Enclosures. Das ist völlig in Ordnung. Nehmen Sie url und bytes aus dem Dateiobjekt für enclosure und duration für itunes:duration.