API da Mapit
Os dados Mapit, nas próprias ferramentas
Consultar a conta, os veículos, onde comunicaram pela última vez e os trajetos efetuados: o mesmo que a aplicação Mapit mostra, a partir de um script, do Home Assistant ou de uma aplicação própria. Sem partilhar a palavra-passe Mapit.
Beta, gratuita por agora. A API da Mapit é uma beta: pode mudar ou deixar de funcionar, não tem garantia de disponibilidade e, por agora, a Mapit não a cobra. Não depender dela para emergências nem para recuperar uma mota roubada: para isso, usar a aplicação Mapit. Ler as condições da beta.
Experimentar
Com uma chave pessoal que possa ver a localização:
curl -H "Authorization: Bearer $MAPIT_KEY" https://api.mapit.me/v1/status A resposta tem uma entrada por veículo, com a última posição comunicada, a bateria e quando comunicou pela última vez.
O que é preciso saber primeiro
- Só leitura. A API não pode alterar a conta, os veículos nem as definições. A única exceção: uma chave pessoal com a opção «Gerir ligações» pode desligar as aplicações e chaves.
- Só os dados da própria conta. Uma chave ou ligação vê os veículos de um cliente, tal como a aplicação Mapit os mostra.
- Localização e trajetos só com autorização. Precisam de uma permissão própria, dada quando a chave ou a ligação é criada.
- Último dado comunicado, não em direto. As posições são o que o localizador enviou por último; cada resposta diz quando.
- 30 pedidos por minuto por chave ou token de acesso. Consultar
/v1/statusuma vez por minuto é mais do que suficiente. Ver Limites. - Estável, tanto quanto uma beta pode ser. O objetivo é que a versão 1 só ganhe campos. Tudo o que possa estragar o código passa para
/v2. Ver Versões.
Assistentes de IA
O Claude, o ChatGPT e outros assistentes compatíveis com MCP ligam-se através de https://api.mapit.me/mcp: adicioná-lo como conector e iniciar sessão com a conta Mapit. Em Usar com IA encontram-se os passos e o que um agente de programação precisa para ler esta documentação.
