RouteMateRouteMate
Developer API

Bouw met RouteMate

Koppel je platform via onze REST-API. Importeer stops vanuit je e-commerceplatform, start routeoptimalisatie en volg leveringen programmatisch.

RouteMate API
POST /v1/integration-import

Verzoek

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

Antwoord

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

Haal credentials op

Genereer je client ID en secret in de instellingen van het RouteMate-dashboard.

Vraag token aan

Wissel je gegevens om voor een bearer token die één uur geldig blijft.

Roep de API aan

Stuur het token mee in de Authorization-header voor import- en statusverzoeken.

Authenticatie

Client credentials flow

De RouteMate API gebruikt een OAuth2 client credentials flow. Wissel je client ID en secret om voor een kortlopende bearer token en stuur die mee in de Authorization-header.

01

Haal credentials op

Genereer je client ID en secret in de instellingen van het RouteMate-dashboard.

02

Vraag token aan

Wissel je gegevens om voor een bearer token die één uur geldig blijft.

03

Roep de API aan

Stuur het token mee in de Authorization-header voor import- en statusverzoeken.

API

Belangrijkste API-endpoints

Deze endpoints dekken de meest voorkomende integratietaken binnen bezorgworkflows.

POST/v1/integration-token

Toegangstoken ophalen

Wissel client credentials om voor een kortlopend toegangstoken dat 1 uur geldig is.

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

Job importeren en route optimaliseren

Importeer een job met stops, geocodeer adressen, optimaliseer de route en wijs een chauffeur toe.

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

Jobstatus opvragen

Controleer job- en stopstatus inclusief bezorgvoortgang en totalen.

Request

// GET request

Response

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

Start binnen enkele minuten

Gebruik de voorbeelden hieronder om te authenticeren, jobs te importeren en bezorgstatus te controleren.

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",
    },
)
Gebouwd voor SaaS-teams

Vanaf dag één productie-klaar

Ontworpen voor betrouwbare bezorgworkflows, retries en downstream-processen.

Veilige authenticatie
Kortlopende bearer tokens en gecontroleerde uitwisseling van credentials.
Snelle imports
Verstuur leveringen vanuit je eigen systeem in één request.
Betrouwbare retries
Gebruik idempotency keys om mislukte requests veilig opnieuw uit te voeren.
Statuszichtbaarheid
Volg jobs en stopvoortgang programmatisch.

Heb je een maatwerk integratie nodig?

Praat met ons over partnerworkflows, aangepaste onboarding en enterprise API-toegang.