Lanzamiento de la API pública gratuita de kilometraje
Cinco endpoints REST, autenticación por API key y free tier de 1.000 peticiones por ventana de 30 días.
Por qué publicamos una API pública
El reembolso de kilometraje es una de las piezas más olvidadas del stack de gastos corporativos.[^irs-2025] La mayoría de los equipos sigue usando hojas de cálculo. La API pública de Quilometragem soluciona esto con cinco endpoints REST: distancia GPS, tarifa oficial por país, cálculo de reembolso, recibo PDF firmado y geocodificación. Todo gratuito hasta 1.000 peticiones por ventana de 30 días por clave.
Los cinco endpoints
`POST /distance` calcula distancia y duración entre dos puntos, aceptando direcciones libres o pares lat/lng. `POST /reimbursement` aplica la tarifa oficial del país y año indicados — actualmente cubrimos US, BR, MX, CO, UK y CA. `POST /receipt` genera un PDF con hash SHA-256 que aguanta auditoría. `GET /rates/{country}/{year}` devuelve la tarifa oficial con link a la fuente. `GET /geocode` convierte una dirección en coordenadas.
Autenticación y límites
La clave va en el header `X-API-Key` (o como Bearer). Cada respuesta lleva `X-RateLimit-Limit` y `X-RateLimit-Remaining`. El free tier de 1.000 peticiones por ventana de 30 días rolling cubre prototipos, hackathons y equipos pequeños. Cuando necesites más, hay un plan partner con volúmenes a medida.
SDKs y OpenAPI
Clientes oficiales en JavaScript/TypeScript (`npm install quilometragem-sdk-js`) y Python (`pip install quilometragem`), ambos bajo licencia MIT. Para otros lenguajes, importa nuestro OpenAPI 3.1 en `https://quilometragem.com/api/openapi.json`. Los ejemplos cURL, Axios, Ruby, Go y PHP están en la documentación interactiva en `/api`.
Cómo empezar en 60 segundos
Inicia sesión, abre `/account/api`, crea una clave (la verás una sola vez) y prueba con cURL al endpoint `/distance`. Recibes distancia en km, duración estimada y polyline de la ruta.