Convenções

Datas#

Todas as datas estão em UTC, ISO 8601: 2026-11-05T09:30:00Z.

IDs#

Os IDs são cadeias opacas de 12 caracteres. Não os interprete.

Paginação#

limit define o tamanho da página. Quando há mais linhas, meta.next_cursor tem valor: envie-o como cursor.

Proteção contra repetição#

Envie Idempotency-Key com 8 a 128 letras, algarismos, - ou _. O resultado é guardado durante 24 horas. A mesma chave com outro corpo devolve 409 idempotency_mismatch. É obrigatório nas execuções e opcional nas escritas.

Idioma#

Defina Accept-Language como en, tr ou pt para as mensagens de erro.

Cabeçalhos de resposta#

Todas as respostas têm X-Request-Id. MessGEO-Account-Notice: payment_past_due surge enquanto um pagamento estiver em atraso.