Integre seu sistema ao Mapogos
A API do Sistema Mapogos permite que painéis, ferramentas de BI e ERPs leiam e gravem dados da locadora — clientes, contratos, pagamentos, frota, oficina e estoque — e recebam avisos automáticos quando algo acontece.
https://apimapogos.sixinformatica.com/v1Do zero à primeira integração funcionando, em 11 etapas com exemplos prontos.
🔑AutenticaçãoComo obter, guardar e usar sua chave de API com segurança.
⚡WebhooksReceba eventos como pagamento confirmado e veículo bloqueado em tempo real.
📚Referência32 módulos documentados: campos, filtros, exemplos de requisição e resposta.
Como funciona
- Sua empresa recebe uma chave criada no painel Mapogos (menu Integrações → API do Sistema), com permissões escolhidas módulo a módulo.
- Seu sistema chama a API enviando a chave no cabeçalho
Authorization. - A API responde em JSON, sempre no mesmo formato:
sucesso,dados,metaerequest_id. - Opcional: o Mapogos avisa seu sistema por webhook quando um evento acontece.
curl -X GET "https://apimapogos.sixinformatica.com/v1/clientes?por_pagina=2" \
-H "Authorization: Bearer $MAPOGOS_API_KEY"<?php
$ch = curl_init('https://apimapogos.sixinformatica.com/v1/clientes?por_pagina=2');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('MAPOGOS_API_KEY'),
],
]);
$resposta = json_decode(curl_exec($ch), true);
$http = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($resposta['sucesso']) {
print_r($resposta['dados']);
} else {
echo $resposta['erro']['mensagem'];
}const resposta = await fetch('https://apimapogos.sixinformatica.com/v1/clientes?por_pagina=2', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.MAPOGOS_API_KEY}`,
},
});
const json = await resposta.json();
if (json.sucesso) console.log(json.dados);
else console.error(json.erro.mensagem);import os, uuid, requests
resposta = requests.request(
"GET",
"https://apimapogos.sixinformatica.com/v1/clientes?por_pagina=2",
headers={"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}"},
timeout=30,
)
json = resposta.json()
print(json["dados"] if json["sucesso"] else json["erro"]["mensagem"])Princípios da API
Cada chave só acessa o que foi liberado. Dados pessoais vêm mascarados sem permissão específica.
Mesmo formato de resposta em todas as rotas, códigos de erro estáveis e request_id para suporte.
Gravações seguem exatamente as regras das telas do Mapogos (baixas, acordos, estoque, OS).
Busque só o que mudou com atualizado_desde e receba eventos por webhook.
Convenções
| Item | Padrão |
|---|---|
| Formato | JSON UTF-8 em requisições e respostas |
| Datas e horas | ISO 8601 no fuso de Belém/Brasília — ex.: 2026-10-08T14:30:00-03:00 |
| Valores em dinheiro | Texto decimal com ponto e 2 casas — ex.: "1234.50" (evita erro de arredondamento) |
| Versão | Na URL (/v1). Mudanças incompatíveis viram uma nova versão; nada muda na v1 sem aviso. |
| Segurança | Somente HTTPS. Chamadas HTTP são recusadas. |