# API Documentation - get video vimeo source URL

## Endpoint

```
POST /api-get-vimeo-source-url.php
```

## Description

Cet endpoint permet de récupérer le lien de téléchargement d'une vidéo hébergée sur viméo du meme compte que celui renseigné sur la plateforme, en qualité maximale.

---

## Required Headers

| Header | Value |
|--------|-------|
| Authorization | `Bearer <token>` ? Un jeton d'authentification valide est requis. |

---

## Request Parameters

**Content-Type:** `application/x-www-form-urlencoded`

| Paramètre        | Type | Obligatoire | Description                                                       |
|------------------|------|-------------|-------------------------------------------------------------------|
| `mediaId`        | int | Non | Id Vimeo du média                                                 |

---

## Success Response

**HTTP Code:** `200 OK`

```json
{
  "downloadLink": "https://player.vimeo.com/wxyz"
}
```

---

## Error Responses

| HTTP Code                   | Cause                                              | Exemple                                                                                                                                  |
|-----------------------------|----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
| `400 Bad Request`           | Paramètres invalides                               | ```json  { "status": "Error", "message": "", "data": [] } ``` |
| `401 Unauthorized`          | Jeton manquant ou invalide                         | ```json  { "status": "Error", "message": "Invalid credentials.", "data": [] } ```                                                        |
| `405 Method Not Allowed`    | Méthode HTTP non autorisée (seul POST est accepté) | ```json { "status": "Error", "message": "Method not allowed.", "data": [] } ```                                                          |
| `500 Internal Server Error` | Erreur interne du serveur                          | ```json { "status": "Error", "message": "An unexpected error occurred.", "data": [] } ```                                                |
| `200 OK`                    | Pas de vidéo trouvée                               | ```json { "status": "Error", "message": "No video file found for the given media ID", "data": [] } ```                                    |
| `200 OK`                    | Pas de lien de téléchargement trouvé               | ```json { "status": "Error", "message": "No download link found for the video file", "data": [] } ```                                    |


---

## ? Notes

- Le jeton d'authentification est requis pour chaque requête.
- Le parametre mediaId est requis
- Seule la méthode `POST` est acceptée.