MapogosAPI Docs
/
Guia

Autenticação e chaves

Toda chamada (exceto /v1/status) é autenticada por uma chave de API enviada no cabeçalho Authorization.

Enviando a chave

Use o esquema Bearer: a palavra Bearer, um espaço e a chave completa.

CabeçalhoValor
AuthorizationBearer mpg_live_XXXXXXXXXXXX_YYYY…
Requisição
Testar ▸
curl -X GET "https://apimapogos.sixinformatica.com/v1/me" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY"

Ciclo de vida da chave

Ação no painelEfeito imediato
CriarGera a chave (exibida uma única vez) com as permissões escolhidas
Editar permissõesVale a partir da próxima chamada, sem trocar a chave
Suspender / ReativarSuspensa responde 401 chave_suspensa até ser reativada
RegenerarCria uma chave nova; a anterior para de funcionar na hora
RevogarDefinitivo: 401 chave_revogada e webhooks desativados
ExpiraçãoApós a data, 401 chave_expirada

Trocando a chave sem parar a integração

  1. Combine uma janela de manutenção curta.
  2. No painel, clique em Regenerar e copie a nova chave.
  3. Atualize a variável MAPOGOS_API_KEY no servidor e reinicie o serviço.
  4. Confirme com GET /v1/me.
!
Suspeita de vazamento?
Regenere a chave imediatamente e revise os Logs da chave no painel (rota, IP e horário de cada chamada).

Restrições de segurança

RecursoPara que serve
Lista de IPsAceita chamadas apenas dos IPs/faixas (CIDR) informados
Limite por minutoProtege a integração de laços infinitos; padrão 120/min
CarteirasRestringe a chave à frota MAPOGOS, Premium ou ambas
CORSDesligado por padrão — a chave é para uso servidor-a-servidor