--- title: "Aan de slag" description: "Aan-de-slag-gids voor het gebruik van de API's" url: "https://api-portal-suitelogi-ppr.stef.com/nl/getting-started" image: "https://api-portal-suitelogi-ppr.stef.com/_og/d/c_Ocean.takumi,title_Aan+de+slag,description_Aan-de-slag-gids+voor+het+gebruik+van+de+API's,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiM1NTk2ZTYifX19,p_Ii9ubC9nZXR0aW5nLXN0YXJ0ZWQi,s_xjtyAftNVixuyu_i.png" --- **Ontwikkelaarsportaal** - [API's](https://api-portal-suitelogi-ppr.stef.com/nl/apis) - [Aan de slag](https://api-portal-suitelogi-ppr.stef.com/nl/getting-started) - [Handleidingen](https://api-portal-suitelogi-ppr.stef.com/nl/guides) - [Ondersteuning](https://api-portal-suitelogi-ppr.stef.com/nl/support) [FR](https://api-portal-suitelogi-ppr.stef.com/)|[EN](https://api-portal-suitelogi-ppr.stef.com/en)|[ES](https://api-portal-suitelogi-ppr.stef.com/es)|[IT](https://api-portal-suitelogi-ppr.stef.com/it)|[PT](https://api-portal-suitelogi-ppr.stef.com/pt)|**[NL](https://api-portal-suitelogi-ppr.stef.com/nl)**|[DE](https://api-portal-suitelogi-ppr.stef.com/de) ## Aan de slag met de API's Volg deze gids om u aan te melden op het portaal, uw applicatie aan te maken, u op API's te abonneren en uw eerste aanroep uit te voeren. ## [1\. Aanmelden op het API-portaal](#_1-aanmelden-op-het-api-portaal) Met de API-portalen van STEF kunt u zich abonneren op STEF-API's via persoonlijke consumerapplicaties of applicaties die binnen een team worden gedeeld. Als STEF-medewerker hoeft u geen accountaanmaak aan te vragen om toegang te krijgen tot de portalen. Ga naar het gewenste portaal en klik tijdens de authenticatie op de knop **Aanmelden als STEF-medewerker**. Raadpleeg de gids met APIM-instanties voor de lijst met beschikbare portalen en hun gebruik. Om een consumerapplicatie te kunnen aanmaken die met uw team wordt gedeeld, moet u de aanmaak van een team aanvragen door een JIRA APIM-ticket aan te maken, met vermelding van de teamnaam en het/de doelportaal/-portalen. ## [2\. Een applicatie aanmaken](#_2-een-applicatie-aanmaken) Om een API te kunnen gebruiken, moet u eerst beschikken over een consumerapplicatie. Bij het aanmaken wordt een **credential** gegenereerd, de identificatie van uw applicatie tijdens een aanroep. 1. Klik rechtsboven in het portaal op uw profiel 2. Klik op de knop **[Applications](https://api-portal-suitelogi-ppr.stef.com/apps)** 3. Klik op de knop **New application** 4. Vul de naam en beschrijving van uw applicatie in 5. Om deze applicatie met uw team te delen, vinkt u **This is a team owned application** aan en selecteert u het gewenste team 6. Klik op de knop **Create application** 7. Noteer de credential die tijdens het aanmaken is gegenereerd Deze credential wordt alleen weergegeven bij het aanmaken van uw applicatie en is daarna niet meer zichtbaar. Bewaar deze zorgvuldig. ## [3\. Zich abonneren op een API](#_3-zich-abonneren-op-een-api) Een consumerapplicatie kan zich, afhankelijk van de behoefte, op een of meerdere API's abonneren. Gebruik het menu **APIs** om de catalogus van beschikbare STEF-API's te raadplegen. Navigeer naar de producten die u interesseren om de technische ontwikkelaarsdocumentatie te openen, die voor elke API het volgende bevat: - De verschillende ondersteunde bewerkingen - De definitie van invoer- en uitvoerobjecten - Codevoorbeelden om ze te gebruiken Om u op een API te abonneren: 1. Open de detailweergave van een API 2. Klik rechtsboven op **Use this API** 3. Klik op de knop **Register** die hoort bij de applicatie waarop u zich wilt abonneren Het abonnement moet daarna door STEF worden gevalideerd; neem hiervoor contact op met uw STEF IT-contactpersoon. Aangezien een applicatie zich op meerdere API's kan abonneren, herhaalt u de abonnementsprocedure voor elke API die u wilt gebruiken. ### [Uw abonnementen raadplegen en beheren](#uw-abonnementen-raadplegen-en-beheren) Om de abonnementen van een applicatie te bekijken, klikt u linksboven op uw profiel en vervolgens op **Applications**, en daarna op de naam van uw applicatie. Op het tabblad **APIs**, dat automatisch wordt weergegeven, vindt u de lijst met uw abonnementen en hun status. U kunt vanuit dit menu ook een abonnement op andere API's aanvragen door op **\+ API** te klikken. ## [4\. Een API gebruiken](#_4-een-api-gebruiken) Alle aanroepen van STEF-API's verlopen via de STEF API Gateway om toegangsbeveiligingsregels toe te passen, de backendservices van het STEF-informatiesysteem te beschermen en aanroepstatistieken te verzamelen. De API Gateway is toegankelijk via de volgende URL's: - Productie: [https://api-suitelogi.stef.com](https://api-suitelogi.stef.com) - Kwalificatie: [https://api-suitelogi-qua.stef.com/](https://api-suitelogi-qua.stef.com/) Om een API te gebruiken en de toegangsbeveiligingsregels na te leven, voegt u de HTTP-header `X-STEF-Client-Id` toe aan het verzoek, ingevuld met de credential van uw consumerapplicatie. De technische ontwikkelaarsdocumentatie biedt voor elke API die op het platform is gepubliceerd codevoorbeelden waarmee u de API Gateway vanuit verschillende talen kunt aanroepen: Shell, Python, Node.js, JavaScript, Go, Java, C# en Ruby. ### [Voorbeeldaanroep](#voorbeeldaanroep) ```bash curl -X GET "https://api.stef.com/v1/transport/orders" \ -H "X-STEF-Client-Id: " \ -H "Content-Type: application/json" ``` Naast de codevoorbeelden biedt de technische ontwikkelaarsdocumentatie formulieren waarmee u API's rechtstreeks vanuit het portaal in interactieve modus kunt aanroepen via de knop **Try it!**. ## [Volgende stappen](#volgende-stappen) ## API-catalogus [API's bekijken →](https://api-portal-suitelogi-ppr.stef.com/nl/apis) ## Technische handleidingen [Handleidingen bekijken →](https://api-portal-suitelogi-ppr.stef.com/nl/guides) ## APIM-instanties [Instanties bekijken →](https://api-portal-suitelogi-ppr.stef.com/nl/getting-started/instances) #### [API's](#apis) - [API-catalogus](https://api-portal-suitelogi-ppr.stef.com/nl/apis) - [Aan-de-slag-gids](https://api-portal-suitelogi-ppr.stef.com/nl/getting-started) #### [Ontwikkelaars](#ontwikkelaars) - [Documentatie](https://api-portal-suitelogi-ppr.stef.com/nl/guides) - [Best practices](https://api-portal-suitelogi-ppr.stef.com/nl/guides/best-practices) - [Portalen](https://api-portal-suitelogi-ppr.stef.com/nl/getting-started/instances) #### [Ondersteuning](#ondersteuning) - [Technische ondersteuning](https://api-portal-suitelogi-ppr.stef.com/nl/support) #### [Talen](#talen) - [Français](https://api-portal-suitelogi-ppr.stef.com/) - [English](https://api-portal-suitelogi-ppr.stef.com/en) - [Español](https://api-portal-suitelogi-ppr.stef.com/es) - [Italiano](https://api-portal-suitelogi-ppr.stef.com/it) - [Português](https://api-portal-suitelogi-ppr.stef.com/pt) - [Nederlands](https://api-portal-suitelogi-ppr.stef.com/nl) - [Deutsch](https://api-portal-suitelogi-ppr.stef.com/de) © 2026 STEF — Alle rechten voorbehouden [Mentions légales](https://www.stef.com/mentions-legales) · [Politique de confidentialité](https://www.stef.com/politique-confidentialite)