Primeiros passos

# Linux / macOS (sessão atual)
export MAPOGOS_API_KEY="mpg_live_SEU_PREFIXO_SEU_SEGREDO"

# arquivo .env do seu projeto (NÃO versione este arquivo)
MAPOGOS_API_KEY=mpg_live_SEU_PREFIXO_SEU_SEGREDO

REM Windows (PowerShell, permanente para o usuário)
setx MAPOGOS_API_KEY "mpg_live_SEU_PREFIXO_SEU_SEGREDO"

curl https://apimapogos.sixinformatica.com/v1/status

curl -X GET "https://apimapogos.sixinformatica.com/v1/me" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY"

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

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"])

<?php
$pagina = 1;
do {
  $ch = curl_init('https://apimapogos.sixinformatica.com/v1/clientes?por_pagina=200&pagina=' . $pagina);
  curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('MAPOGOS_API_KEY')]]);
  $r = json_decode(curl_exec($ch), true);

  foreach ($r['dados'] as $cliente) {
    salvarNoMeuSistema($cliente);
  }
  $pagina++;
} while ($pagina <= $r['meta']['paginas']);

let pagina = 1, paginas = 1;
do {
  const r = await fetch(`https://apimapogos.sixinformatica.com/v1/clientes?por_pagina=200&pagina=${pagina}`, {
    headers: { Authorization: `Bearer ${process.env.MAPOGOS_API_KEY}` },
  }).then(res => res.json());

  for (const cliente of r.dados) await salvarNoMeuSistema(cliente);
  paginas = r.meta.paginas;
  pagina++;
} while (pagina <= paginas);

import os, requests

H = {"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}"}
pagina, paginas = 1, 1
while pagina <= paginas:
    r = requests.get("https://apimapogos.sixinformatica.com/v1/clientes",
                     params={"por_pagina": 200, "pagina": pagina}, headers=H, timeout=30).json()
    for cliente in r["dados"]:
        salvar_no_meu_sistema(cliente)
    paginas = r["meta"]["paginas"]
    pagina += 1

curl -X GET "https://apimapogos.sixinformatica.com/v1/pagamentos?status=pago&criado_desde=2026-10-01&ordenar=-paid_at&campos=id,rental_id,amount,paid_at" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY"

<?php
$ch = curl_init('https://apimapogos.sixinformatica.com/v1/pagamentos?status=pago&criado_desde=2026-10-01&ordenar=-paid_at&campos=id,rental_id,amount,paid_at');
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/pagamentos?status=pago&criado_desde=2026-10-01&ordenar=-paid_at&campos=id,rental_id,amount,paid_at', {
  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/pagamentos?status=pago&criado_desde=2026-10-01&ordenar=-paid_at&campos=id,rental_id,amount,paid_at",
    headers={"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}"},
    timeout=30,
)
json = resposta.json()
print(json["dados"] if json["sucesso"] else json["erro"]["mensagem"])

import os, requests, datetime

H = {"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}"}
ultima = ler_ultima_sincronizacao()          # ex.: "2026-10-08T09:00:00-03:00"
inicio = datetime.datetime.now().astimezone().isoformat(timespec="seconds")

pagina, paginas = 1, 1
while pagina <= paginas:
    r = requests.get("https://apimapogos.sixinformatica.com/v1/pagamentos", headers=H, timeout=30,
                     params={"atualizado_desde": ultima, "por_pagina": 200, "pagina": pagina}).json()
    for p in r["dados"]:
        gravar_ou_atualizar(p["id"], p)
    paginas, pagina = r["meta"]["paginas"], pagina + 1

salvar_ultima_sincronizacao(inicio)

<?php
$ultima = lerUltimaSincronizacao();          // ex.: '2026-10-08T09:00:00-03:00'
$inicio = date('c');
$pagina = 1;
do {
  $url = 'https://apimapogos.sixinformatica.com/v1/pagamentos?' . http_build_query([
    'atualizado_desde' => $ultima, 'por_pagina' => 200, 'pagina' => $pagina]);
  $ch = curl_init($url);
  curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('MAPOGOS_API_KEY')]]);
  $r = json_decode(curl_exec($ch), true);
  foreach ($r['dados'] as $p) gravarOuAtualizar($p['id'], $p);
  $pagina++;
} while ($pagina <= $r['meta']['paginas']);

salvarUltimaSincronizacao($inicio);

curl -X POST "https://apimapogos.sixinformatica.com/v1/clientes" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Maria Fernanda Souza","cpf_cnpj":"529.982.247-25","phone":"(91) 99876-5432","email":"maria@exemplo.com.br","city":"Belém","uf":"PA"}'

<?php
$ch = curl_init('https://apimapogos.sixinformatica.com/v1/clientes');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST  => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . getenv('MAPOGOS_API_KEY'),
    'Content-Type: application/json',
    'Idempotency-Key: ' . bin2hex(random_bytes(16)),
  ],
  CURLOPT_POSTFIELDS     => json_encode([
    'name' => 'Maria Fernanda Souza',
    'cpf_cnpj' => '529.982.247-25',
    'phone' => '(91) 99876-5432',
    'email' => 'maria@exemplo.com.br',
    'city' => 'Belém',
    'uf' => 'PA',
  ]),
]);
$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', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MAPOGOS_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
      "name": "Maria Fernanda Souza",
      "cpf_cnpj": "529.982.247-25",
      "phone": "(91) 99876-5432",
      "email": "maria@exemplo.com.br",
      "city": "Belém",
      "uf": "PA"
  }),
});
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(
    "POST",
    "https://apimapogos.sixinformatica.com/v1/clientes",
    headers={"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}",
             "Idempotency-Key": str(uuid.uuid4())},
    json={
        "name": "Maria Fernanda Souza",
        "cpf_cnpj": "529.982.247-25",
        "phone": "(91) 99876-5432",
        "email": "maria@exemplo.com.br",
        "city": "Belém",
        "uf": "PA"
    },
    timeout=30,
)
json = resposta.json()
print(json["dados"] if json["sucesso"] else json["erro"]["mensagem"])

<?php
// webhook.php — recebe avisos do Mapogos
$segredo = getenv('MAPOGOS_WEBHOOK_SECRET');
$corpo   = file_get_contents('php://input');
$ts      = $_SERVER['HTTP_X_MAPOGOS_TIMESTAMP'] ?? '';
$assin   = $_SERVER['HTTP_X_MAPOGOS_ASSINATURA'] ?? '';

$esperado = 'sha256=' . hash_hmac('sha256', $ts . '.' . $corpo, $segredo);
if (!hash_equals($esperado, $assin) || abs(time() - (int)$ts) > 300) {
  http_response_code(401);
  exit;
}

$evento = json_decode($corpo, true);
if (!jaProcessado($evento['id'])) {          // evita processar duas vezes
  enfileirar($evento);                        // processe depois, responda rápido
}
http_response_code(200);

import crypto from 'node:crypto';
import express from 'express';

const app = express();
app.post('/webhooks/mapogos', express.raw({ type: 'application/json' }), (req, res) => {
  const ts = req.get('X-Mapogos-Timestamp');
  const assin = req.get('X-Mapogos-Assinatura') || '';
  const esperado = 'sha256=' + crypto
    .createHmac('sha256', process.env.MAPOGOS_WEBHOOK_SECRET)
    .update(`${ts}.${req.body}`)
    .digest('hex');

  const valido = assin.length === esperado.length &&
    crypto.timingSafeEqual(Buffer.from(assin), Buffer.from(esperado));
  if (!valido || Math.abs(Date.now() / 1000 - Number(ts)) > 300) return res.sendStatus(401);

  const evento = JSON.parse(req.body);
  enfileirar(evento); // processe depois
  res.sendStatus(200);
});

import hmac, hashlib, os, time, json
from flask import Flask, request, abort

app = Flask(__name__)

@app.post("/webhooks/mapogos")
def mapogos():
    corpo = request.get_data()
    ts = request.headers.get("X-Mapogos-Timestamp", "")
    assin = request.headers.get("X-Mapogos-Assinatura", "")
    esperado = "sha256=" + hmac.new(os.environ["MAPOGOS_WEBHOOK_SECRET"].encode(),
                                    ts.encode() + b"." + corpo, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(esperado, assin) or abs(time.time() - int(ts or 0)) > 300:
        abort(401)
    evento = json.loads(corpo)
    enfileirar(evento)  # processe depois
    return "", 200