Referência da API do Integrador RepMais

Documentação técnica para consulta dos contratos HTTP do BFF Integrador RepMais. A referência expõe endpoints, parâmetros, payloads, modelos, respostas e exemplos de chamada a partir do OpenAPI publicado pelo próprio serviço.

Use QA para validar mudanças de contrato antes da entrega e prod para consultar a documentação vigente do ambiente produtivo.

Consulta por operação

Navegue pelos grupos da API, abra cada endpoint e confira método HTTP, rota, parâmetros obrigatórios, schemas de entrada, respostas previstas e códigos de status.

Teste controlado

A referência mantém o botão de teste do Scalar para apoiar validações rápidas. Selecione o servidor do ambiente correto antes de executar chamadas e confira os payloads esperados pelo contrato publicado.

MCP para integradores

Conecte Claude, Cursor ou outro cliente MCP em um servidor remoto read-only para deixar a IA buscar endpoints, schemas e exemplos diretamente no OpenAPI atual.

Atualização dinâmica

O projeto não mantém uma cópia manual da especificação. A cada acesso, ele consulta o OpenAPI do BFF publicado, então novas rotas e alterações de contrato aparecem após o deploy do serviço no ambiente correspondente.

MCP da API

Servidor MCP remoto

Conecte sua IA na documentação da API RepMais

O API Docs expõe um MCP read-only para clientes compatíveis consultarem o OpenAPI atual. Use isto para acelerar integrações: a IA consegue buscar rotas, ler schemas, abrir detalhes de operações e usar o contrato real como contexto de implementação.

Configuração

Adicione este servidor ao seu cliente MCP com transporte HTTP:

{ "mcpServers": { "repmais-api-docs": { "url": "https://api-docs.repmais.com.br/mcp" } } }
https://api-docs.repmais.com.br/mcp

Claude Code

Em ambientes que suportam cadastro por linha de comando:

claude mcp add --transport http repmais-api-docs https://api-docs.repmais.com.br/mcp

Ferramentas disponíveis

  • list_operations: lista todas as operações HTTP.
  • search_operations: busca endpoints por rota, tag, resumo ou payload.
  • get_operation: retorna o detalhe OpenAPI de uma rota.
  • list_schemas e get_schema: consultam modelos.
  • get_openapi: retorna o OpenAPI completo.

Fallback

Se o cliente ainda não suportar MCP remoto, use o bundle em markdown como contexto manual. Ele contém operações e schemas derivados do OpenAPI atual.

Baixar mcp.md

Referência da API

Chat com IA

Respostas em português com base no OpenAPI atual do Integrador.

Faça uma pergunta sobre endpoints, parâmetros, payloads ou respostas da API.