> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intention.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Questões de API e integração

> Para onde levar as questões de programadores e integradores sobre a API da Intention, o funcionamento interno do protocolo e as integrações comerciais.

Esta página encaminha as questões de programadores e integradores para o sítio certo. Escolha a categoria adequada e siga as instruções aí indicadas.

<Note>
  A referência completa da API está publicada em [openapi.intention-testnet.xyz](https://openapi.intention-testnet.xyz) e o site para programadores em [dev.intention.xyz](https://dev.intention.xyz/). O formato dos payloads ainda está a mudar em alguns pontos, por isso o email é mais rápido do que a especificação para tudo o que pareça inconsistente.
</Note>

<h2 id="questions-about-api-usage">
  Questões sobre a utilização da API
</h2>

Se está a integrar antes de a referência ser publicada, envie um email para `contact@intention.xyz` com uma descrição de uma linha do que está a construir e dos endpoints de que espera precisar. A equipa de integração pode partilhar o formato de trabalho da superfície e assinalar tudo o que provavelmente mudará antes do lançamento.

Quando já estiver a correr contra um endpoint e este se comportar de forma diferente do esperado, envie um email para `contact@intention.xyz` com o corpo do pedido, o corpo da resposta, os cabeçalhos relevantes e a data/hora UTC da chamada. Os tickets que citam o payload problemático e a resposta observada resolvem-se normalmente numa única troca de mensagens, porque a equipa de integração consegue reexecutá-los diretamente contra o ambiente de staging.

<h2 id="questions-about-protocol-internals">
  Questões sobre o funcionamento interno do protocolo
</h2>

Se está a tentar perceber por que razão o protocolo se comporta de determinada maneira — semântica de matching, garantias de sequenciação, fluxo de comissões, matemática da margem, certificação do oráculo —, comece pela secção de arquitetura deste site. A página [IntentionKernel](/pt/protocol/architecture/kernel) cobre a execução; [IntentionBFT](/pt/protocol/architecture/intention-bft) cobre o consenso; a página [Ponte](/pt/protocol/architecture/bridge) cobre depósitos e levantamentos. Se, depois de as ler, continuar com uma questão de natureza arquitetural e não operacional, envie um email para `contact@intention.xyz` com um parágrafo a enquadrar o que quer perceber e a página de onde partiu. A equipa de protocolo faz a triagem dessas questões e ou responde diretamente ou encomenda uma melhoria à documentação, para que o leitor seguinte não tenha de perguntar.

<h2 id="commercial-integration">
  Integração comercial
</h2>

Parcerias, listagens, acordos de market making e tudo o que implique uma relação comercial vão para `contact@intention.xyz`. Inclua uma descrição de uma linha do que está a construir, de quem é e do que precisa da Intention Labs para que funcione. Uma primeira mensagem clara reduz substancialmente as trocas de mensagens.

<h2 id="security-disclosures">
  Divulgação de vulnerabilidades
</h2>

Os problemas de segurança — tudo o que não queira que uma pessoa qualquer na internet veja antes de existir uma correção — vão para `contact@intention.xyz` com **Security** na linha de assunto, para serem encaminhados à frente do correio normal. As regras do programa estão na página [Bug bounty](/pt/protocol/security/bug-bounty). Leia essa página antes de submeter: seguir o procedimento documentado é o que dá direito à recompensa.

<h2 id="summary">
  Resumo
</h2>

| Tema                                        | O que incluir                                                                                                  |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Um endpoint comporta-se de forma inesperada | Corpo do pedido, corpo da resposta, cabeçalhos e a data/hora UTC da chamada                                    |
| Um documento do protocolo é ambíguo         | A página de onde partiu e o que estava a tentar perceber                                                       |
| Integração comercial                        | O que está a construir, quem é e do que precisa da Intention Labs                                              |
| Divulgação de vulnerabilidade               | Colocar **Security** na linha de assunto e seguir o processo de [bug bounty](/pt/protocol/security/bug-bounty) |

Tudo vai para `contact@intention.xyz`. Uma primeira mensagem clara reduz substancialmente as trocas de mensagens.