# Autenticação

> Aprenda como autenticar suas requisições à API.

## Autenticação

Todas as requisições à API devem incluir uma chave de API válida no header `Authorization` usando o esquema Bearer token, junto com o header `x-wayinvideo-api-version`:

```
Authorization: Bearer YOUR_API_KEY
x-wayinvideo-api-version: v2
```

## Obtendo uma Chave de API

1. Faça login no seu [WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard)
2. Clique em **Create API Key** para gerar uma nova chave
3. Copie e guarde sua chave de API — ela será exibida apenas uma vez

> **Importante:** Mantenha sua chave de API em segredo. Nunca a exponha em código do lado do cliente ou repositórios públicos. Se suspeitar que uma chave foi comprometida, exclua-a e crie uma nova imediatamente.

## Fazendo Requisições Autenticadas

Inclua o header `Authorization` em cada requisição:

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"video_url": "https://www.youtube.com/watch?v=example"}'
```

## Respostas de Erro

Se a autenticação falhar, a API retorna **403 Forbidden**. Exemplo de corpo da resposta:

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