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