Liens partagés API

Cette endpoint permet de générer de manière programmée des liens publics sécurisés pour vos actifs multimédias. Ces liens peuvent être protégés par mot de passe et avoir une date d’expiration.

Génération d’un lien partageable

POST /liens-partages

Cette endpoint crée un lien unique pour un seul Vidéo (VOD), une Diffusion en direct ou une Collection de vidéos.

Corps de la requête

Champ	Type	Obligatoire	Description
`media_id`	`string`	Oui	L’ID unique de l’actif. C’est un UUID pour les vidéos.
`media_type`	`string`	Oui	Le type d’actif. Doit être l’un des suivants : `vod`, `live`, `collection`.
`visibility`	`string`	Oui	Le niveau d’accès. Doit être l’un des suivants : `public`, `password`.
`password`	`string`	Facultatif	Obligatoire si `visibility` est `password`. Minimum 6 caractères.
`expires_in_days`	`integer`	Facultatif	Le nombre de jours avant que le lien ne se soit automatiquement expiré. Max 365.

Exemples de requêtes

Pour une Vidéo (VOD)


{
    "media_id": "9c1a9e3e-6c9b-4f8a-8e2d-9b3c1d4e0f6a",
    "media_type": "vod",
    "visibility": "public",
    "expires_in_days": 7
}

Pour une Collection


{
    "media_id": "42",
    "media_type": "collection",
    "visibility": "public"
}

Protégé par mot de passe


{
    "media_id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
    "media_type": "live",
    "visibility": "password",
    "password": "super-secret-password"
}

Exemple de réponse : 201 Créé

À la réussite, le API retournera les détails du lien généré.


{
  "link": "https://votre-app.com/s/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoP",
  "token": "aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoP",
  "visibility": "public",
  "expires_at": "2025-08-17T14:30:00Z"
}