Troubleshooting

​

401 invalid_api_key

• Confirme o header X-API-Key (sem typo no prefixo shp_live_)
• Verifique se a chave não foi revogada no dashboard
• Não use aspas extras no valor do header

​

403 forbidden

• Chave sem escopo media:resolve ou media:download na rota
• Projeto desativado ou inexistente

​

422 unsupported_platform

• Host não suportado — consulte GET /platforms
• URL encurtada: expanda para URL canônica quando possível

​

404 media_not_found

• media_id expirou após o resolve — execute resolve novamente
• media_id de outro projeto

​

Job preso em queued

• Worker pode estar ocupado — aguarde até 60 s
• Verifique limite de concorrência (2 jobs simultâneos)
• Persiste? Abra suporte com request_id do header

​

download_url retorna 403

• URL assinada expirou — consulte o job novamente ou reenfileire
• Não modifique query params da URL assinada

​

Rate limit 429

• Respeite X-RateLimit-Reset
• Reduza frequência de polling em jobs
• Veja Rate limiting

​

Desenvolvimento local

# API local
curl http://localhost:8080/v1/health

# Com chave
curl http://localhost:8080/v1/platforms \
  -H "X-API-Key: shp_test_ou_live_sua_chave"