# Erros

Todos os erros têm o mesmo formato:

```json
{
  "error": {
    "code": "media_required",
    "lang": "pt",
    "message": { "pt": "…", "es": "…", "en": "…" },
    "fix": { "pt": "…", "es": "…", "en": "…" },
    "docs_url": "https://wyroapi.com/docs/errores#media_required",
    "details": { "platform": "instagram" }
  }
}
```

`message` e `fix` sempre trazem todos os idiomas; `lang` diz qual combina com você.

<h2 id="missing_api_key"><code>missing_api_key</code> (HTTP 401)</h2>

A chave de API está faltando.

**Como resolver:** Envie o header "Authorization: Bearer <chave>". Ainda não tem chave? Crie uma de teste com POST /v1/sandbox (sem cadastro).

<h2 id="invalid_api_key"><code>invalid_api_key</code> (HTTP 401)</h2>

A chave de API não é válida ou foi revogada.

**Como resolver:** Confira se a chave começa com "wyro_sk_" e está completa. Você pode criar uma nova com POST /v1/sandbox.

<h2 id="sandbox_expired"><code>sandbox_expired</code> (HTTP 401)</h2>

A chave de teste expirou (ela dura 72 horas).

**Como resolver:** Crie uma nova chave de teste com POST /v1/sandbox, ou conecte uma conta real para continuar com a mesma chave.

<h2 id="key_expired"><code>key_expired</code> (HTTP 402)</h2>

O período de teste terminou.

**Como resolver:** Mostre ao usuário o link em details.payment_url para ativar um plano. A mesma chave volta a publicar, sem reconfigurar nada.

<h2 id="workspace_suspended"><code>workspace_suspended</code> (HTTP 403)</h2>

Este espaço de trabalho está suspenso.

**Como resolver:** Fale com a gente em https://github.com/wyroapi/wyro/issues.

<h2 id="rate_limited"><code>rate_limited</code> (HTTP 429)</h2>

Solicitações demais.

**Como resolver:** Espere os segundos indicados no header Retry-After e tente de novo.

<h2 id="sandbox_limit"><code>sandbox_limit</code> (HTTP 429)</h2>

Foram criadas chaves de teste demais a partir deste IP.

**Como resolver:** Reutilize a chave que você já tem (ela dura 72 horas) ou espere uma hora.

<h2 id="validation_error"><code>validation_error</code> (HTTP 400)</h2>

A solicitação tem dados inválidos.

**Como resolver:** Confira o campo indicado em details e compare com /openapi.json.

<h2 id="platform_not_supported"><code>platform_not_supported</code> (HTTP 400)</h2>

Essa rede social não é suportada.

**Como resolver:** Use uma destas: instagram, facebook, tiktok, linkedin, twitter, threads, youtube, pinterest.

<h2 id="no_account_for_platform"><code>no_account_for_platform</code> (HTTP 400)</h2>

Não há uma conta conectada para essa rede.

**Como resolver:** Liste as contas com GET /v1/accounts. Para conectar uma conta real, use POST /v1/connect.

<h2 id="media_required"><code>media_required</code> (HTTP 400)</h2>

Essa rede precisa de uma imagem ou um vídeo.

**Como resolver:** Adicione "media": [{"url": "https://..."}] com uma URL pública. TikTok e YouTube precisam de vídeo.

<h2 id="text_too_long"><code>text_too_long</code> (HTTP 400)</h2>

O texto passa do limite da rede.

**Como resolver:** Encurte o texto ou publique nessa rede separadamente. Os limites estão em details.

<h2 id="admin_only"><code>admin_only</code> (HTTP 403)</h2>

Esta rota é só para o administrador da plataforma.

**Como resolver:** Use o token de analytics (ANALYTICS_TOKEN) ou o de administrador, não uma chave de espaço de trabalho. As métricas do seu espaço estão em GET /v1/analytics/overview.

<h2 id="invalid_partner_token"><code>invalid_partner_token</code> (HTTP 401)</h2>

O token de parceiro não é válido.

**Como resolver:** Use o token de parceiro que passamos para você, em Authorization: Bearer <token>. Não é a chave de um espaço de trabalho.

<h2 id="workspace_not_found"><code>workspace_not_found</code> (HTTP 404)</h2>

O espaço de trabalho não existe ou não é deste parceiro.

**Como resolver:** Liste seus espaços com GET /v1/partner/workspaces.

<h2 id="post_not_cancellable"><code>post_not_cancellable</code> (HTTP 409)</h2>

Essa publicação não pode mais ser cancelada.

**Como resolver:** Só dá para cancelar publicações agendadas que ainda não saíram. Para apagar um post publicado, faça isso na própria rede.

<h2 id="account_not_disconnectable"><code>account_not_disconnectable</code> (HTTP 409)</h2>

Essa conta não pode ser desconectada.

**Como resolver:** Só contas reais ativas podem ser desconectadas. As contas simuladas do modo de teste, não.

<h2 id="account_not_found"><code>account_not_found</code> (HTTP 404)</h2>

A conta não existe neste espaço de trabalho.

**Como resolver:** Liste as contas com GET /v1/accounts.

<h2 id="post_not_found"><code>post_not_found</code> (HTTP 404)</h2>

A publicação não existe.

**Como resolver:** Confira o id (ele começa com post_). Liste as publicações com GET /v1/posts.

<h2 id="account_disconnected"><code>account_disconnected</code> (HTTP 409)</h2>

Essa conta está desconectada.

**Como resolver:** Peça ao usuário para reconectá-la com o link em details.connect_url (ou POST /v1/connect).

<h2 id="provider_error"><code>provider_error</code> (HTTP 502)</h2>

A rede social não aceitou a publicação neste momento.

**Como resolver:** Se details.retryable for true, tente de novo em um minuto. Se não, confira o conteúdo (formato, duração, tamanho) e a conta conectada.

<h2 id="post_not_reschedulable"><code>post_not_reschedulable</code> (HTTP 409)</h2>

Esse post não está mais agendado: só dá para reagendar um post que ainda não saiu.

**Como resolver:** Consulte o status com GET /v1/posts/{id}. Se ele já foi publicado, crie um post novo com POST /v1/posts.

<h2 id="not_found"><code>not_found</code> (HTTP 404)</h2>

A rota não existe.

**Como resolver:** Veja /openapi.json para conhecer as rotas disponíveis.

<h2 id="internal_error"><code>internal_error</code> (HTTP 500)</h2>

Algo falhou do nosso lado.

**Como resolver:** Tente de novo em alguns segundos. Se continuar acontecendo, abra um issue em https://github.com/wyroapi/wyro/issues com o request_id.
