> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/pt-br/web-scraper-api/response-codes.md).

# Códigos de resposta

Descubra os códigos de resposta da Web Scraper API, desde estados de sucesso e redirecionamento até resultados de análise e explicações de erro.

O Web Scraper API retorna códigos de quatro partes diferentes do serviço, e cada um aparece em um lugar diferente na resposta:

* [**API**](/products/pt-br/web-scraper-api/response-codes.md#api) - Códigos de status HTTP. O status da própria resposta HTTP, e o `status_code` de cada página coletada em `results`.
* [**Analisadores**](/products/pt-br/web-scraper-api/response-codes.md#parsers) - `parse_status_code` dentro do `conteúdo` de um resultado (somente quando `parse` é `true`).
* [**Carregador para armazenamento em nuvem**](/products/pt-br/web-scraper-api/response-codes.md#cloud-storage-uploader) – entradas no `statuses` array do objeto job, quando os resultados são enviados para o seu armazenamento.
* [**Sessões**](/products/pt-br/web-scraper-api/response-codes.md#sessions) - códigos relacionados à sessão.

Alguns alvos também têm seus próprios códigos, por exemplo, os estados de vídeo do YouTube (`11201`–`11211`), que são listados em **Códigos de erro** nas [Metadados do YouTube](/api-targets/pt-br/video-and-social-media/youtube/youtube-metadata.md), [Legendas do YouTube](/api-targets/pt-br/video-and-social-media/youtube/youtube-subtitles.md) e [Baixador do YouTube](/api-targets/pt-br/video-and-social-media/youtube/youtube-downloader.md) páginas.

### API

<table><thead><tr><th width="103.23558797355886">Código</th><th width="279.42175953228775">Status</th><th>Descrição</th></tr></thead><tbody><tr><td><code>200</code></td><td><code>OK</code></td><td>Tudo correu bem, você recebeu o que pediu.</td></tr><tr><td><code>202</code></td><td><code>Aceito</code></td><td>Sua solicitação foi aceita.</td></tr><tr><td><code>204</code></td><td><code>Sem conteúdo</code></td><td>Você está tentando recuperar um job que ainda não foi concluído.</td></tr><tr><td><code>400</code></td><td><code>Várias mensagens de erro</code></td><td>Estrutura de solicitação incorreta: um parâmetro obrigatório ausente, um valor inválido/escrito incorretamente ou um valor do tipo errado. O corpo da resposta tem uma mensagem de erro mais específica.</td></tr><tr><td><code>401</code></td><td><p><code>Cabeçalho de autorização não fornecido</code></p><p><code>Cabeçalho de autorização inválido</code></p><p><code>Cliente não encontrado</code></p></td><td>O cabeçalho de autorização está ausente, ou suas credenciais de login estão incorretas.</td></tr><tr><td><code>403</code></td><td><code>Proibido</code></td><td>Sua conta não tem acesso a este recurso.</td></tr><tr><td><code>404</code></td><td><code>Não encontrado</code></td><td>O ID do job que você está procurando não existe ou não está mais disponível.</td></tr><tr><td><code>422</code></td><td><code>Entidade não processável</code></td><td>Há algo errado com o payload que você nos enviou. Certifique-se de que é um objeto JSON válido.</td></tr><tr><td><code>429</code></td><td><code>Muitas solicitações</code></td><td>Você excedeu o limite de taxa. Entre em contato com seu gerente de conta para aumentar seus limites.</td></tr><tr><td><code>500</code></td><td><code>Erro interno do servidor</code></td><td>Estamos enfrentando alguns problemas do nosso lado. Tente novamente um pouco mais tarde. Provavelmente já estamos cientes dos problemas, mas você pode nos avisar e relatar mesmo assim.</td></tr><tr><td><code>524</code></td><td><code>Tempo limite</code></td><td>Serviço indisponível.</td></tr><tr><td><code>612</code></td><td><code>Erro interno indefinido</code></td><td>Algo deu errado e falhamos o job que você enviou. Você pode tentar novamente sem custo extra, pois não cobramos por <code>com falha</code> jobs. Se isso não funcionar, fale conosco.</td></tr><tr><td><code>613</code></td><td><code>Com falha após muitas tentativas</code></td><td>Algo deu errado, e falhamos o job que você enviou. Você pode tentar novamente sem custo extra, pois não cobramos por <code>com falha</code> jobs. Se isso não funcionar, entre em contato conosco.</td></tr></tbody></table>

### Analisadores

<table><thead><tr><th width="151.673345890383">Código</th><th width="210">Status</th><th>Descrição</th></tr></thead><tbody><tr><td><code>12000</code></td><td><code>Sucesso</code></td><td>O conteúdo analisado retornado está completo, e não deve haver campos ausentes ou quebrados.</td></tr><tr><td><code>12002</code></td><td><code>Falha</code></td><td>Não conseguimos analisar a página por completo. Pode haver um problema com o site de destino ter alterado sua estrutura HTML.</td></tr><tr><td><code>12003</code></td><td><code>Não suportado</code></td><td>A página da web que você nos pediu para analisar não é suportada.</td></tr><tr><td><code>12004</code></td><td><code>Sucesso parcial</code></td><td>Conseguimos analisar a maior parte da página. No entanto, alguns campos estão ausentes.</td></tr><tr><td><code>12005</code></td><td><code>Sucesso parcial</code></td><td>Conseguimos analisar a maior parte da página. No entanto, alguns campos podem ter valores padrão porque não conseguimos encontrá-los no HTML.</td></tr><tr><td><code>12006</code></td><td><code>Falha</code></td><td>Erro inesperado. Avise-nos que você recebeu esta resposta, e verificaremos o que deu errado.</td></tr><tr><td><code>12007</code></td><td><code>Desconhecido</code></td><td>Status desconhecido dos dados analisados. O resultado real pode variar de uma falha completa a um sucesso total.</td></tr><tr><td><code>12008</code></td><td><code>Falha</code></td><td>O conteúdo analisado está ausente.</td></tr><tr><td><code>12009</code></td><td><code>Falha</code></td><td>Produto não encontrado. Verifique a URL que você enviou.</td></tr></tbody></table>

### Carregador para armazenamento em nuvem

Esses códigos são retornados no `statuses` array do objeto job. Um upload com falha não altera o job `status`, que permanece `concluído`, então verifique `statuses` se os resultados não chegarem ao seu armazenamento.

<table><thead><tr><th width="156.30558722919042">Código</th><th width="208">Status</th><th>Descrição</th></tr></thead><tbody><tr><td><code>10001</code></td><td><code>Exceção inesperada</code></td><td>Algo errado aconteceu. Provavelmente já sabemos disso e estamos corrigindo. Avise-nos mesmo assim.</td></tr><tr><td><code>13000</code></td><td><code>Upload bem-sucedido</code></td><td>Tudo certo!</td></tr><tr><td><code>13001</code></td><td><code>Upload falhou</code></td><td>Não conseguimos enviar os resultados do job para o seu bucket.</td></tr><tr><td><code>13102</code></td><td><code>Não há tal caminho</code></td><td>Não conseguimos encontrar um bucket com esse nome. Verifique novamente.</td></tr><tr><td><code>13103</code></td><td><code>Acesso negado</code></td><td>O bucket não tem as permissões necessárias. Para descobrir como nos conceder o acesso necessário, veja <a href="/products/pt-br/web-scraper-api/features/result-processing-and-storage/cloud-storage.md"><strong>aqui</strong></a>.</td></tr></tbody></table>

### Sessões

<table><thead><tr><th width="162">Código</th><th width="208">Status</th><th>Descrição</th></tr></thead><tbody><tr><td><code>15001</code></td><td><code>Sessão expirada</code></td><td>A sessão que você está tentando usar expirou. Agora você pode criar outra sessão com o mesmo <code>session_id</code> se quiser.</td></tr><tr><td><code>15002</code></td><td><code>Falha na sessão</code></td><td>A criação da sessão falhou. Tente novamente.</td></tr><tr><td><code>15003</code></td><td><code>Falha na atualização da sessão</code></td><td>A atualização da sessão falhou. Tente novamente.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/pt-br/web-scraper-api/response-codes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.