# Como resolver o erro "Invalid payload" na integração de API

Encontrar erros durante o desenvolvimento de software e a integração de APIs é algo comum. Um problema frequente é o erro **“Invalid payload”**, geralmente acompanhado por uma mensagem como:

```json
errorMessage: Invalid payload. Error: Unexpected character ('<' (code 60)): expected a valid value
```

## O que causa o erro?

A principal causa desse erro é a incompatibilidade entre o formato de dados esperado e o formato real recebido do serviço externo. Quando o conector espera dados em **JSON**, mas recebe outro formato, como **XML**, ele não consegue processar a resposta corretamente, resultando no erro **Invalid payload**.

## Como resolver o problema?

Corrigir o erro **Invalid payload** envolve identificar e alinhar os formatos de dados esperados e recebidos. Siga estas etapas para solucionar o problema:

1. **Identifique a origem**: Descubra qual endpoint ou serviço externo está retornando um formato de dados inesperado. Você pode fazer isso analisando a mensagem de erro e rastreando sua origem.
2. **Ative o Advanced Settings:** Acesse as configurações do conector que está gerando o erro e habilite o Advanced Settings.&#x20;
3. **Ative o Raw Mode**: Depois de ativar o **Advanced Settings**, habilite o **Raw Mode**. Isso permitirá visualizar a resposta bruta enviada pelo serviço externo.
4. **Salve e implante**: Salve as alterações e implante a nova versão do conector. Na próxima vez que o erro ocorrer, os detalhes serão exibidos no formato enviado pelo endpoint externo, facilitando a identificação da causa do problema.

<figure><img src="/files/XmkTJ5tlofSF2hY9lchJ" alt=""><figcaption></figcaption></figure>

## Conclusão

O erro **Invalid payload** é um obstáculo comum na integração de APIs, geralmente causado por discrepâncias entre os formatos de dados do conector e do serviço externo. Compreendendo a causa raiz do erro e seguindo as etapas acima, você pode resolvê-lo de forma eficaz e garantir uma comunicação fluida entre a aplicação e serviços externos.


---

# Agent Instructions: 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:

```
GET https://docs.digibee.com/documentation/troubleshooting/pt-br/integration-issues/invalid-payload.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.