API développeur

Développez avec RouteMate

Connectez votre plateforme via notre API REST pour importer des arrêts, lancer l'optimisation et suivre les livraisons.

API RouteMate

POST /v1/integration-import

Requête

{
  "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
    }
  ]
}

Réponse

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

Obtenir les identifiants

Générez votre identifiant et votre secret client depuis les réglages du tableau de bord RouteMate.

Demander un jeton

Échangez vos identifiants contre un jeton bearer valable une heure.

Appeler l'API

Ajoutez le jeton dans l'en-tête Authorization des requêtes suivantes.

Authentification

Flux d'identifiants client

L'API RouteMate utilise OAuth2 avec identifiants client. Échangez votre identifiant et votre secret contre un jeton temporaire.

Obtenir les identifiants

Générez votre identifiant et votre secret client depuis les réglages du tableau de bord RouteMate.

Demander un jeton

Échangez vos identifiants contre un jeton bearer valable une heure.

Appeler l'API

Ajoutez le jeton dans l'en-tête Authorization des requêtes suivantes.

API

Core API Endpoints

These endpoints cover the most common delivery workflow integration tasks.

POST/v1/integration-token

Get Access Token

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

Request

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

Response

{
  "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.

Request

{
  "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
    }
  ]
}

Response

{
  "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.

Request

// GET request

Response

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

Code Examples

Get started in minutes

Use the examples below to authenticate, import jobs, and check delivery status.

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",
    },
)

Built for SaaS Teams

Production-ready from day one

Designed for reliable delivery workflows, retries, and downstream operations.

Secure auth

Short-lived bearer tokens and controlled credential exchange.

Fast imports

Push deliveries from your own system in a single request.

Reliable retries

Use idempotency keys to safely retry failed requests.

Status visibility

Track jobs and stop progress programmatically.

Besoin d'une intégration sur mesure ?

Parlez-nous des workflows partenaires, de l'onboarding personnalisé et de l'accès API enterprise.