> For the complete documentation index, see [llms.txt](https://selenium-4.gitbook.io/nexus-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://selenium-4.gitbook.io/nexus-docs/helpcenter/troubleshooting/overview.md).

# Troubleshooting

Códigos de erro frequentes, falhas de integração e o que fazer quando um serviço falha.

## Códigos HTTP frequentes

Estes códigos aplicam-se tanto à obtenção de token como às chamadas subsequentes às APIs protegidas:

| Código | Estado                | Descrição                                                                  | Ação recomendada                                                                      |
| ------ | --------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| 200    | OK                    | Pedido processado com sucesso.                                             | —                                                                                     |
| 400    | Bad Request           | Parâmetros em falta ou inválidos no pedido (ex.: `grant_type` incorrecto). | Validar o payload contra a documentação da operação.                                  |
| 401    | Unauthorized          | `client_id`/`client_secret` inválidos, ou `access_token` expirado/ausente. | Confirmar credenciais; renovar o token.                                               |
| 403    | Forbidden             | Cliente desactivado ou sem permissões no realm/domínio.                    | Contactar o suporte para validar permissões.                                          |
| 404    | Not Found             | `realm` ou endpoint informado não existe.                                  | Confirmar o nome do realm e o path do endpoint documentado.                           |
| 500    | Internal Server Error | Erro inesperado no servidor.                                               | Repetir o pedido; se persistir, contactar o suporte com o `correlation id`/timestamp. |

## Falhas de integração comuns

* **Token expira a meio de um fluxo longo** — renove o `access_token` proactivamente, usando o `expires_in` devolvido na resposta, em vez de esperar pelo `401`.
* **Credenciais de um ambiente usadas noutro** — cada `realm` é isolado por cliente/ambiente (QA/PRD); credenciais de QA não funcionam em PRD e vice-versa.
* **Payload rejeitado com `400`** — confirme que está a usar o `Content-Type` correcto (`application/x-www-form-urlencoded` na obtenção de token; `application/json` nas restantes operações) e que os campos obrigatórios da tabela de payload da operação estão preenchidos.
* **Resposta inesperada de um domínio de serviço** — confirme a versão do BIAN documentada na página da operação (`BIAN Version`) e se o endpoint corresponde ao ambiente pretendido.

## O que fazer quando um serviço falha

1. Confirme se o problema é de autenticação (`401`/`403`) ou do próprio domínio de serviço (`400`/`404`/`500`).
2. Reveja a página **Overview** e a página da operação específica no catálogo de serviços para confirmar payloads e regras de negócio esperadas.
3. Repita o pedido — falhas `500` pontuais podem ser transitórias.
4. Se o erro persistir, contacte o suporte com: domínio de serviço, operação, ambiente (QA/PRD), código HTTP devolvido e, se possível, o corpo da resposta de erro (sem incluir `client_secret` ou `access_token`).

Para questões de credenciais e acesso, consulte [Account & Access](/nexus-docs/helpcenter/account-access/overview.md).


---

# 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 following URL with the `ask` and `goal` query parameters:

```
GET https://selenium-4.gitbook.io/nexus-docs/helpcenter/troubleshooting/overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.