# Códigos de Status

> Códigos de status HTTP e formatos de resposta da API WayinVideo.

## Códigos de Status

A API usa códigos de status HTTP padrão. O formato do corpo da resposta depende do código de status.

---

## 200 OK

A requisição foi bem-sucedida. O corpo da resposta é JSON contendo apenas o payload em `data`.

**Exemplo**

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

---

## 400 Bad Request

Ocorreu um erro do lado do cliente — parâmetros inválidos, formato de vídeo não suportado ou outros problemas de entrada. Revise o campo `message`, corrija a requisição e tente novamente.

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `trace_id` | string | Identificador único para diagnóstico e suporte |
| `message` | string | Descrição do erro legível por humanos |

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

---

## API Units insuficientes

Se a conta não tem API Units suficientes para enviar a tarefa, a API retorna **400 Bad Request**. A tarefa não é criada e nenhuma unidade é debitada. O corpo traz `message` e `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"
}
```

As tarifas estão em [Faturamento](https://wayin.ai/pt/api-docs/pricing/).

---

## 500 Internal Server Error

Ocorreu um erro do lado do servidor. Se o problema persistir, entre em contato com o suporte informando o `trace_id`.

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

---

## 403 Forbidden

Falha na autenticação (chave de API inválida ou ausente). O corpo da resposta inclui:

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `timestamp` | string | Hora da resposta (ISO 8601) |
| `status` | number | Código de status HTTP (403) |
| `error` | string | Tipo de erro curto (ex.: `"Forbidden"`) |
| `path` | string | Caminho da requisição |

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

---

## 429 Too Many Requests

A requisição foi rejeitada devido a limites de taxa ou de concorrência. O corpo da resposta usa o mesmo formato que o 403: `timestamp`, `status`, `error`, `path`.

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

Consulte [Limites de Taxa](https://wayin.ai/pt/api-docs/rate-limits/) para os valores dos limites e como evitar o erro 429.