# Aviso de privacidade da API

Este aviso explica o que acontece aos seus dados pessoais quando usa a API da Mapit com uma chave pessoal ou uma aplicação ligada. Junta-se à [Política de Privacidade](https://mapit.me/pt-pt/politica-de-privacidade/) da Mapit e à parte de proteção de dados dos [Termos e Condições Gerais](https://mapit.me/pt-pt/termos-e-condicoes-2/), que cobrem tudo o resto.

Em vigor desde 17 de novembro de 2026. Última atualização: 18 de novembro de 2026.

## 1. Quem é o responsável

O responsável pelo tratamento é a sociedade da Mapit indicada no seu contrato: em Espanha, Mapit IoT, S.L., calle Casp 172, 4B, 08013 Barcelona, NIF B-66716291. Pode escrever ao encarregado de proteção de dados da Mapit para [gdpr@mapit.me](mailto:gdpr@mapit.me).

## 2. O que devolve a API

A API só devolve dados da sua própria conta, e só a uma chave ou aplicação que criou ou aprovou. Devolve os mesmos dados que a app da Mapit lhe mostra:

| Dados | Quem os pode ler |
| --- | --- |
| O seu nome, email, idioma e fuso horário | Todas as chaves e ligações |
| Os seus veículos: nome, modelo, matrícula, quilómetros, estado da subscrição e data de fim | Todas as chaves e ligações |
| Última posição enviada, bateria e estado do dispositivo, com a hora a que foram registados | Só se assinalou **localização** |
| Trajetos: hora de início e de fim, distância, duração, velocidade média e máxima, o percurso no mapa e as estatísticas de condução | Só se assinalou **histórico de trajetos** |

A API nunca devolve dados de pagamento nem mostra os números internos de conta, dispositivo ou veículo da Mapit. Usa códigos que só servem para a sua conta.

## 3. Aplicações que liga

- Quando liga uma aplicação, como o Home Assistant ou um assistente de IA, a Mapit envia-lhe os dados que permitiste. A partir daí, quem oferece essa aplicação decide o que faz com eles. É responsável pelo tratamento por conta própria e aplica-se a sua política de privacidade, não a da Mapit.
- Desligar uma aplicação impede que lhe cheguem dados novos. Não apaga os dados que já recebeu. Para isso, pedi-lo a quem oferece a aplicação.
- Pode ver e desligar as suas aplicações e chaves quando quiser em [login.mapit.me/connections](https://login.mapit.me/connections).

## 4. O que a Mapit regista quando usa a API

### As suas chaves e ligações

De cada chave ou ligação a Mapit guarda: a sua conta, o nome que deu à chave ou o nome da aplicação, as permissões, quando foi criada, quando termina e se foi apagada. As chaves e os tokens só são guardados como uma impressão digital num só sentido (um hash), pelo que a Mapit não os consegue recuperar.

### Registos de pedidos

De cada pedido a Mapit guarda uma linha com:

- o tipo de pedido (por exemplo, «estado do veículo»), não o endereço completo;
- o código de resposta (por exemplo, 200 ou 429) e quanto demorou;
- o tipo de cliente: chave pessoal, Home Assistant, Claude, ChatGPT, um programa no próprio computador ou outra aplicação;
- o seu número de conta Mapit (não nos pedidos de assistentes de IA) e um código curto que distingue as suas chaves e ligações entre si.

O registo não contém o endereço que chamou, os seus parâmetros, a sua chave ou token, nem os dados devolvidos. A Mapit usa estes registos para que o serviço funcione, encontrar falhas e travar abusos.

### Início de sessão

Quando inicia sessão para gerir chaves ou ligar uma aplicação, a página de início de sessão passa o seu email e a sua palavra-passe à Amazon Cognito, o sistema que verifica as palavras-passe da Mapit. A palavra-passe nunca é guardada nem registada. Para travar quem tenta adivinhar palavras-passe, a Mapit conta as tentativas falhadas durante pouco tempo (ver a página [Limites](https://developers.mapit.me/pt/limits.md)), associadas a uma impressão digital do seu endereço IP. A Mapit também regista cada passo da ligação de uma aplicação (início de sessão bem ou mal sucedido, permissões pedidas e concedidas, ligação criada, renovada ou removida) com o tipo de aplicação, mas não a conta, o email nem o endereço IP.

### Análise de utilização

A Mapit usa o PostHog, alojado na UE, para contar quantas pessoas usam a API. Só recebe estes eventos, ligados ao seu número de conta Mapit e não ao seu nome nem ao seu email:

- foi ligada uma aplicação (o tipo de aplicação, o seu nome e as permissões);
- foi aberta a página para ligar uma aplicação (o tipo de aplicação e as permissões que pediu);
- foi criada uma chave pessoal (as permissões; nunca a chave nem o seu nome);
- uma chave ou ligação nova foi usada pela primeira vez (o tipo de aplicação, o tipo de pedido e quanto tempo depois de ser criada);
- uma vez por dia para cada tipo de aplicação usada (Home Assistant, uma chave pessoal, Claude, ChatGPT, um programa no computador ou outra aplicação): os tipos de pedido feitos nesse dia, como «estado do veículo» ou o nome de uma ferramenta de IA, e o nome e a versão do programa cliente, como `HomeAssistant/2026.8.2`. É enviado quando a aplicação volta a chamar num dia posterior;
- cada pedido que um assistente de IA faz através da ligação MCP (o nome da ferramenta, quanto tempo demorou, se falhou e como, o nome e o modelo do assistente, um código de conversa e os nomes, não os valores, do que foi pedido).

O PostHog não recebe o seu endereço IP, a sua localização, os seus trajetos nem qualquer outro dado que a API devolva. A localização a partir do IP está desativada.

## 5. Para que o faz a Mapit

- Para lhe dar a API que pediu: execução do seu contrato com a Mapit.
- Registos de pedidos, limites e controlos de segurança: para proteger o serviço e os seus dados e travar abusos. É um interesse legítimo da Mapit: prestar um serviço seguro.
- Análise de utilização: para saber como a API é usada e melhorá-la. É um interesse legítimo da Mapit: perceber e melhorar a API. Pode opor-se a qualquer momento escrevendo para [gdpr@mapit.me](mailto:gdpr@mapit.me).

## 6. Durante quanto tempo a Mapit os guarda

| Dados | São guardados |
| --- | --- |
| Registos de pedidos | Um mês; depois são apagados automaticamente. |
| Registos de chaves e ligações | Até à data em que a chave ou ligação terminaria (na página [Limites](https://developers.mapit.me/pt/limits.md) está quanto duram as chaves), mesmo que a apague antes; depois são apagados automaticamente. As cópias de segurança são guardadas até 35 dias mais. |
| Sessão iniciada | Tão curta como indica a página [Limites](https://developers.mapit.me/pt/limits.md). |
| Análise de utilização no PostHog | No máximo 12 meses. |
| Resumo diário de utilização (o último dia de uso, até ser enviado ao PostHog) | Até 400 dias depois da última chamada. |

Os dados da sua conta, dos seus veículos, da sua localização e dos seus trajetos são guardados como indica a [Política de Privacidade](https://mapit.me/pt-pt/politica-de-privacidade/). Usar a API não altera isso.

## 7. Quem os trata por conta da Mapit

| Fornecedor | Para quê | Onde |
| --- | --- | --- |
| Amazon Web Services | Executa a API, o início de sessão, o armazenamento e os registos | Irlanda (UE), região eu-west-1 |
| Amazon CloudFront e AWS WAF | Entregam os pedidos e bloqueiam abusos. Não guardam registos de pedidos para a Mapit. | Servidores perto de si na Europa ou na América do Norte |
| PostHog | Análise de utilização | UE |

Alguns destes fornecedores tratam dados fora do Espaço Económico Europeu: servidores da CloudFront na América do Norte e as casas-mãe norte-americanas da AWS e do PostHog. A Mapit só usa fornecedores que se apoiam nas garantias que o RGPD exige para essas transferências, como as cláusulas contratuais-tipo da Comissão Europeia ou uma decisão de adequação. Pode pedir detalhes para [gdpr@mapit.me](mailto:gdpr@mapit.me).

## 8. Os seus direitos

Tem os direitos que constam dos Termos e Condições Gerais: acesso, retificação, apagamento, limitação, oposição, portabilidade e não ficar sujeito a decisões automatizadas. Para os exercer, escrever para [gdpr@mapit.me](mailto:gdpr@mapit.me).

Pode apresentar reclamação a uma autoridade de proteção de dados: em Portugal a CNPD ([www.cnpd.pt](https://www.cnpd.pt/)), em Espanha a AEPD ([www.aepd.es](https://www.aepd.es/)). Não precisa de se dirigir primeiro à Mapit.

## 9. Alterações

Se mudar o que a API regista, a Mapit atualizará este aviso e a sua data antes da alteração.
