Guia

Sincronização incremental

Mantenha uma cópia dos dados atualizada buscando apenas o que mudou desde a última vez.

Como funciona

Com atualizado_desde, a listagem traz registros criados ou alterados a partir da data-hora informada. O Mapogos registra as alterações dos módulos principais (clientes, locações, pagamentos, parcelas, veículos, multas, OS e outros) por 90 dias.

Estratégia recomendada:

Carga inicial com exportação por cursor.
A cada X minutos: atualizado_desde = início da última sincronização.
Grave pelo id (upsert).
Para eventos imediatos, use também webhooks.

✓

Use o início, não o fim

Salve a hora em que a sincronização começou. Assim nada que mude durante a leitura fica de fora (registros repetidos são normais e o upsert resolve).

Requisição

Testar ▸

curl -X GET "https://apimapogos.sixinformatica.com/v1/locacoes?atualizado_desde=2026-10-08T09:00:00-03:00&por_pagina=200" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY"

<?php
$ch = curl_init('https://apimapogos.sixinformatica.com/v1/locacoes?atualizado_desde=2026-10-08T09:00:00-03:00&por_pagina=200');
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/locacoes?atualizado_desde=2026-10-08T09:00:00-03:00&por_pagina=200', {
  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/locacoes?atualizado_desde=2026-10-08T09:00:00-03:00&por_pagina=200",
    headers={"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}"},
    timeout=30,
)
json = resposta.json()
print(json["dados"] if json["sucesso"] else json["erro"]["mensagem"])

Cobertura por módulo

A página de cada módulo na referência informa como atualizado_desde funciona nele: coluna própria, registro de alterações ou pela data de criação (neste caso a resposta avisa em meta.avisos).