MapogosAPI Docs
/
API REST · JSON · HTTPS

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.

URL basehttps://apimapogos.sixinformatica.com/v1

Como funciona

  1. Sua empresa recebe uma chave criada no painel Mapogos (menu Integrações → API do Sistema), com permissões escolhidas módulo a módulo.
  2. Seu sistema chama a API enviando a chave no cabeçalho Authorization.
  3. A API responde em JSON, sempre no mesmo formato: sucesso, dados, meta e request_id.
  4. Opcional: o Mapogos avisa seu sistema por webhook quando um evento acontece.
Exemplo: listar clientes
Testar ▸
curl -X GET "https://apimapogos.sixinformatica.com/v1/clientes?por_pagina=2" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY"

Princípios da API

Segura por padrão

Cada chave só acessa o que foi liberado. Dados pessoais vêm mascarados sem permissão específica.

Previsível

Mesmo formato de resposta em todas as rotas, códigos de erro estáveis e request_id para suporte.

Regras do sistema

Gravações seguem exatamente as regras das telas do Mapogos (baixas, acordos, estoque, OS).

Sincronizável

Busque só o que mudou com atualizado_desde e receba eventos por webhook.

Convenções

ItemPadrão
FormatoJSON UTF-8 em requisições e respostas
Datas e horasISO 8601 no fuso de Belém/Brasília — ex.: 2026-10-08T14:30:00-03:00
Valores em dinheiroTexto decimal com ponto e 2 casas — ex.: "1234.50" (evita erro de arredondamento)
VersãoNa URL (/v1). Mudanças incompatíveis viram uma nova versão; nada muda na v1 sem aviso.
SegurançaSomente HTTPS. Chamadas HTTP são recusadas.