Erros da API
A Web Scraping API retorna códigos de status HTTP padrão. Respostas não-2xx incluem um corpo JSON com um campo error descrevendo o que deu errado.
Códigos de erro
Seção intitulada “Códigos de erro”| Código | Significado |
|---|---|
400 | Bad Request. A requisição está malformada ou tem parâmetros inválidos. Também retornado quando a URL de destino não pôde ser raspada. |
401 | Unauthorized. A chave de API está ausente, inválida, ou a cota de créditos foi excedida. |
403 | Forbidden. Seu plano não inclui este recurso (por exemplo, renderização JavaScript ou geolocalização específica de país). Faça upgrade da sua assinatura para usá-lo. |
406 | Not Acceptable. O formato de resposta solicitado não é suportado. |
422 | Unprocessable Entity. A requisição era válida, mas não pôde ser atendida. Causas comuns: o site de destino retornou um CAPTCHA sob um 200 OK, o HTML da resposta está vazio, um perfil do Instagram retornou a página de login, ou um seletor wait_for_css nunca apareceu. |
429 | Too Many Requests. Você está enviando requisições rápido demais ou executando muitas em paralelo. O Google também pode retornar isso quando detecta o scraper. |
500 | Internal Server Error. Algo quebrou do nosso lado. Tente novamente em breve. |
503 | Service Unavailable. A API está temporariamente offline para manutenção. Tente novamente mais tarde. |
Semântica de repetição
Seção intitulada “Semântica de repetição”- Repita
500e503com backoff exponencial (por exemplo, 1s, 2s, 4s). - Repita
429após uma pausa, e reduza a concorrência de requisições. - Não repita
400,401,403, ou406sem alterar a requisição.
Veja também
Seção intitulada “Veja também”- Web Scraping API - hub de endpoints
- Requisição básica - exemplo mínimo de chamada