# Inline Share | AudioDN Docs

> Öffentliche Redirect-URLs ohne Authentifizierung zum Teilen einer einzelnen Track-Variante in sozialen Medien.

Source: https://audiodeliverynetwork.com/de/docs/api/share/

---

# 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](https://account.audiodeliverynetwork.com) 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.