# 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](https://developers.mapit.me/pt/terms.md).

- [Chaves pessoais](https://developers.mapit.me/pt/keys.md): Para scripts próprios. Criar uma chave, colá-la e pronto.
- [OAuth](https://developers.mapit.me/pt/oauth.md): Para aplicações que ligam outros clientes Mapit, com o consentimento deles.
- [Home Assistant](https://developers.mapit.me/pt/home-assistant.md): A mota como rastreador de dispositivo e sensores.
- [Usar com IA](https://developers.mapit.me/pt/ai.md): Ligar um assistente à conta ou indicar esta documentação a um agente de programação.
- [Referência da API](https://developers.mapit.me/pt/reference.md): Todos os endpoints, parâmetros e campos.

## Experimentar

Com uma [chave pessoal](https://developers.mapit.me/pt/keys.md) 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/status` uma vez por minuto é mais do que suficiente. Ver [Limites](https://developers.mapit.me/pt/limits.md).
- **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](https://developers.mapit.me/pt/versions.md).

## 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](https://developers.mapit.me/pt/ai.md) encontram-se os passos e o que um agente de programação precisa para ler esta documentação.
