# Codes de Statut

> Codes de statut HTTP et formats de réponse pour l'API WayinVideo.

## Codes de Statut

L'API utilise les codes de statut HTTP standard.

---

## 200 OK

La requête a réussi. Le corps de la réponse est un JSON contenant uniquement le contenu dans `data`.

```json
{"data": {"project_id": "prj06928fdjqqaza", "name": "Sample project name", "status": "SUCCEEDED"}}
```

---

## 400 Bad Request

Une erreur côté client — paramètres invalides, format vidéo non pris en charge ou autres problèmes d'entrée. Vérifiez le champ `message` et réessayez.

| Champ | Type | Description |
|-------|------|-------------|
| `trace_id` | string | Identifiant unique pour le diagnostic |
| `message` | string | Description de l'erreur lisible par un humain |

```json
{"message": "the error message", "trace_id": "the_trace_id"}
```

---

## API Units insuffisantes

Si le compte n'a pas assez d'API Units pour soumettre la tâche, l'API renvoie **400 Bad Request**. Aucune tâche n'est créée et aucune unité n'est débitée. Le corps contient `message` et `trace_id`.

```json
{
  "message": "Your API units are insufficient. Please purchase more to continue: https://wayin.ai/wayinvideo/api-dashboard",
  "trace_id": "the_trace_id"
}
```

Les tarifs sont sur la page [Facturation](https://wayin.ai/fr/api-docs/pricing/).

---

## 500 Internal Server Error

Une erreur côté serveur. Si le problème persiste, contactez le support en fournissant le `trace_id`.

```json
{"message": "the error message", "trace_id": "the_trace_id"}
```

---

## 403 Forbidden

L'authentification a échoué. La réponse inclut : `timestamp`, `status`, `error`, `path`.

```json
{"timestamp": "2026-03-13T07:58:46.156+00:00", "status": 403, "error": "Forbidden", "path": "/api/v2/clips"}
```

---

## 429 Too Many Requests

Limite de débit ou de concurrence dépassée. Même format que 403.

```json
{"timestamp": "2026-03-10T15:52:01.610+00:00", "status": 429, "error": "Too Many Requests", "path": "/api/v2/clips/results/prjxxx"}
```

Consultez [Limites de Débit](https://wayin.ai/fr/api-docs/rate-limits/) pour les valeurs de limite.