Construye una app de kilometraje en 50 líneas de código
Tutorial paso a paso usando el SDK JavaScript oficial y Express.
El objetivo
Vamos a construir una pequeña app que recibe origen, destino y país, calcula la distancia GPS, aplica la tarifa oficial y devuelve un recibo PDF — todo en menos de 50 líneas de Node.js.[^irs-2025] El ingrediente secreto es el SDK oficial `quilometragem-sdk-js`.
Prerrequisitos
Node.js 18+ y una clave de API. Consíguela en `https://quilometragem.com/account/api` (gratis, 1.000 peticiones por ventana de 30 días).
Paso 1: instalar dependencias
``` npm init -y npm install express quilometragem-sdk-js ```
Paso 2: el servidor
``` import express from 'express'; import { Quilometragem } from 'quilometragem-sdk-js'; const app = express(); app.use(express.json()); const qkm = new Quilometragem({ apiKey: process.env.QKM_API_KEY });
app.post('/quote', async (req, res) => { const { origin, destination, country = 'mx', employeeName } = req.body; const route = await qkm.distance({ origin, destination }); const r = await qkm.reimbursement({ distanceKm: route.distance, country }); const receipt = await qkm.receipt({ employeeName, origin, destination, distanceKm: route.distance, ratePerKm: r.ratePerKm, currency: r.currency, }); res.json({ distance: route.distance, amount: r.amount, currency: r.currency, receiptUrl: receipt.url, hash: receipt.hash }); }); app.listen(3000); ```
Paso 3: probar
``` QKM_API_KEY=qkm_live_… node server.js curl -X POST localhost:3000/quote -H 'Content-Type: application/json' \ -d '{"origin":"CDMX","destination":"Querétaro","country":"mx","employeeName":"Ada"}' ```
La respuesta trae distancia, monto, link público del recibo y hash SHA-256.
Próximo paso: producción
Añade caché de 24h por par origen-destino, middleware de autenticación y monitorea `X-RateLimit-Remaining` para alertar antes del límite.