Inline Share

Inline-Share-Keys lassen Sie einen Key an eine URL hängen, die jeder öffnen kann — kein Authorization-Header, kein Wiedergabesession-Handshake. Jede Anfrage validiert den Key, signiert eine kurzlebige CDN-URL für die Variante des Keys und gibt eine 302-Weiterleitung zur Audiodatei zurück.

Hohe Nutzung

Share-Links sind öffentlich. Jeder mit der URL kann streamen, bis der Key abläuft oder gelöscht wird. Jede Anfrage zählt zur Play-Nutzung und Abrechnung. Setzen Sie nach Möglichkeit ein Ablaufdatum und löschen Sie Keys, die Sie nicht mehr brauchen.

Share-Key erstellen

Gehen Sie im AudioDN-Dashboard zu Settings → API Keys und erstellen Sie einen Inline Share Key. Sie müssen genau eine Variante auswählen. Optional können Sie den Key auf eine Sammlung oder einen Track beschränken.

Share-URL-Format

Hängen Sie Ihren Inline-Share-Key an den Stream-Endpunkt für den Track an, den Sie teilen möchten:

https://api.audiodelivery.net/v1/stream/{track_id}/{share_key}

Die Organisations-ID ist im Key-Präfix kodiert — Sie müssen sie nicht im Pfad angeben.

GET /v1/stream/:track_id/:api_key

Validiert einen Inline-Share-Key und leitet zu einer signierten CDN-URL für die Variante des Keys weiter

Parameter

Name	Typ	Erforderlich	Beschreibung
`track_id`	uuid	Erforderlich	ID des zu streamenden Tracks (Pfadparameter)
`api_key`	string	Erforderlich	Inline-Share-Key einschließlich Org-Präfix (Pfadparameter)

Antwort

HTTP/1.1 302 Found
Location: https://{org_domain}/{file_path}?verify={hmac_token}
Cache-Control: no-store

Es wird kein JSON-Körper zurückgegeben. Der Client folgt der Weiterleitung, um Audio von der CDN-Domain Ihrer Organisation zu streamen. Die signierte URL ist eine Stunde gültig; fordern Sie die Share-URL erneut an, um ein frisches Token zu erzeugen.

Key-Geltungsbereich

Organisationsweit — jeder Track in Ihrer Organisation (Standard)
Sammlung — nur Tracks in der angegebenen Sammlung
Track — nur der angegebene Track (wenn auch die Sammlung gesetzt ist)

Die einzelne Variante des Keys wird immer erzwungen. Anfragen für Tracks außerhalb des Key-Geltungsbereichs geben 404 zurück.