# Tus datos de Mapit, en tus propias herramientas

Lee tu cuenta, tus vehículos, dónde informaron por última vez y las rutas que has hecho: lo mismo que muestra la app de Mapit, desde un script, Home Assistant o una aplicación que tú crees. Sin compartir tu contraseña de Mapit.

> **Beta, gratis por ahora.** La API de Mapit es una beta: puede cambiar o dejar de funcionar, no tiene garantía de disponibilidad y hoy Mapit no la cobra. No dependas de ella para emergencias ni para recuperar una moto robada: para eso, usa la app de Mapit. [Lee las condiciones de la beta](https://developers.mapit.me/es/terms.md).

- [Claves personales](https://developers.mapit.me/es/keys.md): Para tus propios scripts. Crea una clave, pégala y listo.
- [OAuth](https://developers.mapit.me/es/oauth.md): Para aplicaciones que conectan a otros clientes de Mapit, con su permiso.
- [Home Assistant](https://developers.mapit.me/es/home-assistant.md): Tu moto como rastreador de dispositivo y sensores.
- [Usar con IA](https://developers.mapit.me/es/ai.md): Conecta un asistente a tu cuenta o dale esta documentación a un agente de programación.
- [Referencia de la API](https://developers.mapit.me/es/reference.md): Todos los endpoints, parámetros y campos.

## Pruébala

Con una [clave personal](https://developers.mapit.me/es/keys.md) que pueda ver la ubicación:

```
curl -H "Authorization: Bearer $MAPIT_KEY" https://api.mapit.me/v1/status
```

La respuesta trae una entrada por vehículo, con su última posición, su batería y cuándo informó por última vez.

## Lo primero que debes saber

- **Solo lectura.** La API no puede cambiar tu cuenta, tus vehículos ni tus ajustes. La única excepción: una clave personal con la opción «Gestionar conexiones» puede desconectar tus aplicaciones y claves.
- **Solo tus datos.** Una clave o una conexión ve los vehículos de un cliente, tal como los muestra la app de Mapit.
- **La ubicación y las rutas, solo si las permites.** Necesitan su propio permiso, que se da al crear la clave o la conexión.
- **Último dato recibido, no en directo.** Las posiciones son lo último que envió el localizador; cada respuesta dice cuándo.
- **30 peticiones por minuto** por clave o token de acceso. Consultar `/v1/status` una vez por minuto es más que suficiente. Consulta [Límites](https://developers.mapit.me/es/limits.md).
- **Estable, en la medida en que puede serlo una beta.** Queremos que la versión 1 solo gane campos. Todo lo que rompería tu código irá a `/v2`. Consulta [Versiones](https://developers.mapit.me/es/versions.md).

## Asistentes de IA

Claude, ChatGPT y otros asistentes compatibles con MCP se conectan a través de `https://api.mapit.me/mcp`: añádelo como conector e inicia sesión con tu cuenta de Mapit. En [Usar con IA](https://developers.mapit.me/es/ai.md) tienes los pasos, y lo que necesita un agente de programación para leer esta documentación.
