API integratie

Routix biedt een versiebeheerde REST API waarmee externe applicaties, zoals ERP-systemen, WMS-platformen, BI-tools en AI-agents, veilig toegang krijgen tot je transportmanagementdata.

De API is gebouwd op OAuth 2.1 en gebruikt een proxylayer voor stabiliteit, versiebeheer en fijnmazige toegangscontrole.

Gebruikersniveau: Gevorderd

OAuth flow

Routix gebruikt OAuth 2.1 om externe applicaties te authenticeren. Voor API-integraties is client credentials de ondersteunde flow.

Client credentials flow

Gebruik deze flow voor server-to-servercommunicatie. Er is geen gebruikersinteractie nodig.

Sequence

Vraag een token aan


curl -X POST https://api.routix.com/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "routix_..."
  }'

Response:


{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "bearer",
  "expires_in": 3600,
  "scope": "routix:accounts:read routix:orders:read",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "branch_ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ]
}

Belangrijke concepten

Scopes

Elke API-actie wordt beschermd door een scope met dit patroon:


routix:<resource>:<action>

Scope	Beschrijving
routix:accounts:read	Lees klanten, leveranciers en vervoerders.
routix:accounts:write	Maak accounts aan en werk ze bij.
routix:orders:read	Lees orders.
routix:orders:write	Maak orders aan en werk ze bij.
routix:projects:write	Bewerk projecten.
routix:shipments:write	Bewerk zendingen.
routix:trips:write	Bewerk ritten.
routix:vehicles:read	Lees voertuigen.
routix:vehicles:write	Maak voertuigen aan en werk ze bij.
routix:items:write	Bewerk items.
routix:tariffs:write	Bewerk tarieven.
routix:zones:write	Bewerk zones.
routix:quotations:write	Bewerk offertes.
routix:staff:read	Lees medewerkers.
routix:equipment:read	Lees equipment.
routix:planning:read	Lees planning- en routedata.
routix:invoices:read	Lees facturen.
routix:invoices:write	Maak facturen aan en werk ze bij.

Resource scoping

De API gebruikt afhankelijk van de resource een organization UUID of een branch UUID in het pad. Bijvoorbeeld:

Organization UUID: 123e4567-e89b-12d3-a456-426614174000
Branch UUID: 550e8400-e29b-41d4-a716-446655440000

Dat betekent:

branches, organizations, users en master_data gebruiken de organization UUID.
Resources zoals accounts, projects, shipments en trips gebruiken de branch UUID.
Toegang kan nog steeds beperkt worden via de configuratie van de OAuth-app.

API versioning

Versie	Gedrag
v1	Stabiele, onveranderlijke veldset die veilig is voor productie-integraties.
v2	Uitbreiding van v1 met extra velden die in de tijd kunnen groeien.

Beide versies draaien naast elkaar. Gebruik v1 voor stabiele contracten en v2 als je extra data nodig hebt.

Gerelateerde pagina’s

API calls en voorbeelden
Setup guide