Een partner API-toegang geven
Maak een API-toegangsintegratie met eigen sleutel, geheim, rechten, toegestane IP-adressen en limiet, en laat partners veilig opnieuw proberen.
Bijgewerkt 13 oktober 2026
Een API-toegangsintegratie geeft een partner, een klant of je eigen software eigen inloggegevens om de Transportial-API te gebruiken. Jij bepaalt precies wat er mag. Omdat elke partner een aparte integratie krijgt, kun je de activiteit ervan zien en de toegang intrekken zonder dat iemand anders daar last van heeft.
De toegang aanmaken
- Open het zijmenu (☰, rechtsboven), kies Integraties en klik op + Integratie aanmaken.
- Vul een Naam in die zegt wie hem gebruikt, bijvoorbeeld "Orderportaal klant X".
- Kies bij Selecteer integratietype de optie Integratie via API-toegang.
- Kies bij Selecteer rechten wat de partner mag, bijvoorbeeld transportorders lezen en aanmaken. Geef alleen wat nodig is.
- Klik op Genereren om de toegangssleutel en Geheime sleutel aan te maken, of vul je eigen in.
- Voeg eventueel de IP-adressen van de partner toe. Aanroepen vanaf andere adressen worden geweigerd.
- Stel eventueel Maximaal aantal requests per minuut in om je platform te beschermen tegen zwaar gebruik.
- Zet Uit/Aan op aan en klik op Opslaan.
- Deel de toegangssleutel en het geheim via een veilig kanaal met de partner.
Iedereen met de sleutel en het geheim kan op je platform handelen binnen de rechten die je hebt gekozen. Stuur ze nooit via gewone e-mail of chat, en genereer nieuwe als je denkt dat ze zijn uitgelekt.
Toegang wijzigen of intrekken
- Wil je de rechten wijzigen, open dan de integratie, klik op het potlood (✎), wijzig Selecteer rechten en klik op Opslaan.
- Wil je de partner nieuwe inloggegevens geven, klik dan opnieuw op Genereren en sla op. De oude werken dan niet meer.
- Wil je de toegang tijdelijk stoppen, zet dan Uit/Aan op uit en sla op.
- Wil je de toegang definitief stoppen, klik dan op Verwijderen bij de rij in de lijst met integraties.
De partner veilig opnieuw laten proberen met een Idempotency-Key
Als een aanroep een time-out krijgt, weet de software van de partner niet of Transportial de order al heeft aangemaakt. Om dubbele orders te voorkomen, kan de software bij het aanmaken een header Idempotency-Key meesturen met een unieke waarde, bijvoorbeeld het eigen ordernummer. Komt hetzelfde verzoek nog eens binnen met dezelfde sleutel, dan geeft Transportial het eerste antwoord terug in plaats van de order twee keer aan te maken. Dat antwoord heeft de header Idempotency-Replayed: true.
- Dezelfde sleutel met een ander verzoek wordt geweigerd met status 422.
- Een herhaling terwijl het eerste verzoek nog loopt, krijgt status 409; de partner probeert het even later opnieuw.
- Alleen geslaagde antwoorden worden onthouden. Mislukte het eerste verzoek, dan kan dezelfde sleutel opnieuw worden gebruikt.
Dit werkt standaard bij elke aanmaakaanroep. Beheerders kunnen het voor het hele platform aanpassen:
- Open het zijmenu (☰, rechtsboven) en kies Instellingen.
- Klik op het tabblad Omgeving en open het onderdeel Integraties.
- Controleer onder API: veilig opnieuw proberen (Idempotency-Key) dat Idempotency-Key-header respecteren aanstaat.
- Stel Uren dat een sleutel onthouden wordt in (standaard 24). Daarna kan een sleutel opnieuw worden gebruikt.
- Geef eventueel bij Operaties de API-operaties op die de header respecteren, gescheiden door komma's, bijvoorbeeld
create:*, update:trip. Laat het leeg voor alle aanmaakoperaties. - Klik onderaan de pagina op Opslaan.
De partner naar de documentatie verwijzen
Ontwikkelaars vinden de API-documentatie in het ontwikkelaarsportaal. Zie Bouwen op Transportial als ontwikkelaar.