Plataforma
A base comum a todas as formas de integrar — mesma API key, mesma cobrança, mesmos limites e o mesmo formato de relatório.
Tudo nesta seção vale para qualquer forma de integrar com o Minha CNH. A API REST e o Servidor MCP não são dois produtos com regras próprias: são duas portas para a mesma plataforma.
| O que é compartilhado | Onde está documentado |
|---|---|
| A chave que autentica as duas portas | Autenticação |
| A cobrança por relatório e os rate limits | Limites e cobrança |
| Como evitar cobrar duas vezes pelo mesmo pedido | Idempotência |
| O formato do relatório que você recebe | Shape do payload |
| O que mudou e quando | Changelog |
Ou seja: uma API key vale para as duas portas, um relatório custa o mesmo por onde for pedido, e o
externalRef que protege contra duplicidade funciona igual nas duas.
Depois daqui, escolha a porta
- API REST — integração server-to-server. Você faz
POST, recebe por webhook ou polling. É o caminho para backends, ETLs e automações. - Servidor MCP — o mesmo dado exposto via Model Context Protocol, para que agentes de IA descubram e chamem as ferramentas sozinhos.
Se ainda não decidiu, Introdução compara as duas.