API para desarrolladores

Desarrolla con RouteMate

Conecta tu plataforma mediante nuestra API REST. Importa paradas desde tu e-commerce, activa la optimización y sigue entregas por programación.

API de RouteMate

POST /v1/integration-import

Solicitud

{
  "external_job_id": "BATCH-001",
  "title": "Morning Deliveries",
  "driver_email": "driver@example.com",
  "stops": [
    {
      "external_stop_id": "STOP-1",
      "address": "1 George St, Brisbane QLD 4000",
      "label": "Customer A",
      "parcel_count": 2
    }
  ]
}

Respuesta

{
  "job_id": "e7ad097b-...",
  "optimization": {
    "total_distance_km": 12.4,
    "total_duration_minutes": 25
  },
  "stops": [ /* optimized order */ ],
  "warnings": [...]
}

Obtén credenciales

Genera tu client ID y client secret desde la página de configuración del panel de RouteMate.

Solicita el token

Intercambia tus credenciales por un token bearer válido durante una hora.

Llama a la API

Incluye el token en la cabecera Authorization para importaciones y consultas de estado.

Autenticación

Flujo de credenciales de cliente

La API de RouteMate usa OAuth2 con credenciales de cliente. Intercambia tu client ID y tu secreto por un token temporal e inclúyelo en la cabecera Authorization.

Obtén credenciales

Genera tu client ID y client secret desde la página de configuración del panel de RouteMate.

Solicita el token

Intercambia tus credenciales por un token bearer válido durante una hora.

Llama a la API

Incluye el token en la cabecera Authorization para importaciones y consultas de estado.

API

Endpoints principales

Estos endpoints cubren las tareas de integración más comunes del flujo de entregas.

POST/v1/integration-token

Get Access Token

Exchange client credentials for a short-lived access token valid for 1 hour.

Solicitud

{
  "client_id": "rm_ci_your_client_id",
  "client_secret": "rm_cs_your_client_secret"
}

Respuesta

{
  "access_token": "rm_at_e5988dd1b91a...",
  "token_type": "Bearer",
  "expires_in": 3600
}

POST/v1/integration-import

Import Job & Optimize Route

Import a job with stops, geocode addresses, optimize the route, and assign the driver.

Solicitud

{
  "external_job_id": "BATCH-001",
  "title": "Morning Deliveries",
  "driver_email": "driver@example.com",
  "stops": [
    {
      "external_stop_id": "STOP-1",
      "address": "1 George St, Brisbane QLD 4000",
      "label": "Customer A",
      "parcel_count": 2
    }
  ]
}

Respuesta

{
  "job_id": "e7ad097b-...",
  "optimization": {
    "total_distance_km": 12.4,
    "total_duration_minutes": 25
  },
  "stops": [ /* optimized order */ ],
  "warnings": [...]
}

GET/v1/integration-jobs

Query Job Status

Check job and stop status, including delivery progress and counts.

Solicitud

// GET request

Respuesta

{
  "job_id": "e7ad097b-...",
  "status": "assigned",
  "stop_count": 3,
  "status_counts": {
    "pending": 2,
    "completed": 1
  },
  "stops": [...]
}

Ejemplos de código

Empieza en minutos

Usa los ejemplos siguientes para autenticarte, importar trabajos y consultar el estado de las entregas.

curl

curl -X POST https://api.routemate.app/v1/integration-token \
  -H "Content-Type: application/json" \
  -d '{"client_id":"rm_ci_your_client_id","client_secret":"rm_cs_your_client_secret"}'

node

const tokenRes = await fetch("https://api.routemate.app/v1/integration-token", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    client_id: "rm_ci_your_client_id",
    client_secret: "rm_cs_your_client_secret",
  }),
});

python

import requests

token_res = requests.post(
    "https://api.routemate.app/v1/integration-token",
    json={
        "client_id": "rm_ci_your_client_id",
        "client_secret": "rm_cs_your_client_secret",
    },
)

Pensado para equipos SaaS

Listo para producción desde el primer día

Diseñado para flujos fiables, reintentos y operaciones posteriores.

Autenticación segura

Tokens bearer temporales y control de credenciales.

Importaciones rápidas

Envía entregas desde tu sistema en una sola petición.

Reintentos seguros

Usa claves de idempotencia para repetir peticiones con seguridad.

Visibilidad del estado

Sigue trabajos y progreso de paradas por programación.

¿Necesitas una integración personalizada?

Habla con nosotros sobre flujos de partners, onboarding personalizado y acceso enterprise a la API.