afAPIFullDEVELOPERS
GUIAS DE INTEGRAÇÃO

Da primeira chamada
ao seu próximo agente.

Tudo o que você precisa para conectar sua aplicação à API Full.

01 / AUTENTICAÇÃO

Uma conta. Seu token.

Acesse a plataforma e copie o Bearer Token da sua conta. Envie-o no cabeçalho Authorization em cada chamada. Use Content-Type: application/json para consultas JSON.

Authorization: Bearer SEU_TOKEN
Content-Type: application/json
Accept: application/json

O token pertence à conta que terá os créditos consumidos. Guarde-o no servidor da sua aplicação.

02 / PRIMEIRA REQUISIÇÃO

Comece pelo saldo.

Confira o saldo antes de fazer sua primeira consulta.

curl https://api.apifull.com.br/api/get-balance \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Accept: application/json'

Escolha uma consulta na referência da API, preencha os campos obrigatórios e use o valor exato de link indicado no contrato. Em rotas legadas, verifique também o campo status no corpo: um HTTP 200 pode conter uma falha.

03 / MODEL CONTEXT PROTOCOL

A documentação no contexto do seu agente.

Conecte um cliente compatível com MCP por Streamable HTTP. A busca e a leitura dos contratos são públicas. Para executar consultas habilitadas, configure também o cabeçalho de autenticação.

https://doc.apifull.com.br/mcp

Transporte: Streamable HTTP · Autenticação da execução: Bearer Token da API Full. O cliente precisa permitir cabeçalhos personalizados; não há login OAuth neste endpoint.

FerramentaO que faz
search_documentationEncontra consultas e serviços por nome ou categoria.
get_operationRetorna os parâmetros e o contrato de uma operação.
execute_consultationExecuta consultas habilitadas com seu token e confirmação de consumo.

Ao configurar seu agente, peça que confirme os dados e o possível consumo de créditos antes de executar. O argumento confirmCharge deve ser true. Envie o token somente no cabeçalho da conexão.

Exemplo de inicialização MCP por HTTP
curl https://doc.apifull.com.br/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
    "protocolVersion":"2025-11-25","capabilities":{},
    "clientInfo":{"name":"minha-integracao","version":"1.0.0"}
  }}'

Após inicializar, envie a notificação notifications/initialized. Nas próximas chamadas, inclua MCP-Protocol-Version: 2025-11-25. Use tools/list para descobrir os schemas das ferramentas.

04 / RESPOSTAS E CRÉDITOS

Integre com previsibilidade.

A disponibilidade dos dados varia conforme a base consultada. Os campos de dados podem mudar e estar ausentes. Use o contrato da operação para os parâmetros de entrada e trate respostas de erro antes de acessar o resultado.

Se houver timeout, confira o extrato antes de repetir: a consulta pode ter sido processada e cobrada. O MCP não repete automaticamente consultas.

Você também pode importar o OpenAPI atual no Postman. Uma cópia importada precisa ser sincronizada novamente quando o contrato mudar.