wyro

Erros

Todos os erros têm o mesmo formato:

{
  "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ê.

missing_api_key (HTTP 401)

A chave de API está faltando.

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

invalid_api_key (HTTP 401)

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.

sandbox_expired (HTTP 401)

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.

key_expired (HTTP 402)

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.

workspace_suspended (HTTP 403)

Este espaço de trabalho está suspenso.

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

rate_limited (HTTP 429)

Solicitações demais.

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

sandbox_limit (HTTP 429)

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.

validation_error (HTTP 400)

A solicitação tem dados inválidos.

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

platform_not_supported (HTTP 400)

Essa rede social não é suportada.

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

no_account_for_platform (HTTP 400)

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.

media_required (HTTP 400)

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.

text_too_long (HTTP 400)

O texto passa do limite da rede.

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

admin_only (HTTP 403)

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.

invalid_partner_token (HTTP 401)

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

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

workspace_not_found (HTTP 404)

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

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

post_not_cancellable (HTTP 409)

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.

account_not_disconnectable (HTTP 409)

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.

account_not_found (HTTP 404)

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

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

post_not_found (HTTP 404)

A publicação não existe.

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

account_disconnected (HTTP 409)

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).

provider_error (HTTP 502)

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.

post_not_reschedulable (HTTP 409)

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.

not_found (HTTP 404)

A rota não existe.

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

internal_error (HTTP 500)

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.