036 535 80 70 helpdesk@reflex-systems.nl
Documentatie

Authenticatie op de ReflexBlue Externe API

2026-07-10 11:51 UTC
English
Externe API

Elk HTTP-verzoek aan de ReflexBlue Externe API moet vergezeld zijn van een geldig autorisatietoken. Je krijgt zo’n token via een speciaal API-eindpunt. Hiervoor log je in met een gebruikersnaam en wachtwoord van een ReflexBlue gebruiker die is gekoppeld aan een Externe seat en een rol met de juiste gebruikersrechten. De benodigde rechten kunnen verschillen per versie van de API. Hieronder lees je hoe je dit regelt.

Wil je weten hoe je gebruikers en rollen aanmaakt en instelt in ReflexBlue? Kijk dan op Gebruikers en rollen in ReflexBlue.

Als je niet beschikt over het External Seats / API plangebruik in je ReflexBlue plan, dan kan je geen Externe seats aanmaken via het Reflex Cloud Portal. Neem in dat geval contact op met ReflexSystems.

Authenticatie eindpunten

De volgende eindpunten kunnen worden gebruikt om in- en uit te loggen.

Http-methode Eindpunt Omschrijving
POST /api/security/login Login met gebruikersnaam en wachtwoord die een token voor authenticatie aan toonder terugstuurt.
POST /api/security/logout Doet effectief niets.

Het uitvoeren van het login verzoek

Gebruik een HTTP POST verzoek naar het login eindpunt met de volgende JSON payload:

{
    "username": "string",
    "password": "string"
}

De server zal antwoorden met de volgende JSON gegevens:

{
    "token": "string"
}

De waarde van het token bevat een JWT autorisatietoken dat kan worden gebruikt in de Authorization HTTP-verzoekheader bij al je volgende API-verzoeken.

Authenticatie voor versie 1 van de API

Vereisten voor de ReflexBlue API-gebruiker

Om te kunnen authenticeren en versie 1 van de integratie API te gebruiken, heb je een ReflexBlue gebruiker nodig die aan de volgende eisen voldoet:

  • De gebruiker is gekoppeld aan een Externe seat.

  • De gebruiker heeft een rol met deze rechten:

    Module Applicatie Recht
    Administraties Externe API Toegang tot administratie
    Integraties Externe API Externe API-toegang

    Zorg ervoor dat de rol is aangemaakt in de ReflexBlue administratie waarmee je koppelt.

Een autorisatietoken verkrijgen

Log in met de hierboven beschreven ReflexBlue gebruiker via het login-eindpunt van de Externe API. Het autorisatietoken dat je ontvangt, stuur je vervolgens mee in de HTTP-verzoekheaders bij al je volgende API-verzoeken.

Authenticatie voor versie 2 van de API

Vereisten voor de ReflexBlue API-gebruiker

Om te kunnen authenticeren en versie 2 van de Externe API te gebruiken, heb je een ReflexBlue gebruiker nodig die aan de volgende eisen voldoet:

  • De gebruiker is gekoppeld aan een Externe seat.

  • De gebruiker heeft een rol met deze rechten:

    Module Applicatie Recht
    Administraties Externe API Toegang tot administratie

    En een of meerdere van de onderstaande rechten:

    Module Applicatie Recht
    Integraties API V2 Externe API Toegang tot artikelen
    Integraties API V2 Externe API Toegang tot artikelgroepen
    Integraties API V2 Externe API Toegang tot bestelpatronen
    Integraties API V2 Externe API Toegang tot betaalcondities
    Integraties API V2 Externe API Toegang tot contactpersonen
    Integraties API V2 Externe API Toegang tot dynamische velden
    Integraties API V2 Externe API Toegang tot facturen
    Integraties API V2 Externe API Toegang tot integraties
    Integraties API V2 Externe API Toegang tot orders
    Integraties API V2 Externe API Toegang tot pakbonnen
    Integraties API V2 Externe API Toegang tot recepturen
    Integraties API V2 Externe API Toegang tot relaties
    Integraties API V2 Externe API Toegang tot relatiegroepen
    Integraties API V2 Externe API Toegang tot routes
    Integraties API V2 Externe API Toegang tot talen
    Integraties API V2 Externe API Toegang tot productieopdrachten
    Integraties API V2 Externe API Toegang tot webhooks

    Zorg ervoor dat de rol is aangemaakt in de ReflexBlue administratie waarmee je koppelt.

Een autorisatietoken verkrijgen

Log in met de hierboven beschreven ReflexBlue gebruiker via het login-eindpunt van de Externe API. Het autorisatietoken dat je ontvangt, stuur je vervolgens mee in de HTTP-verzoekheaders bij al je volgende API-verzoeken.

Geldigheid van autorisatietokens

Een autorisatietoken voor ReflexBlue is beperkt geldig, meestal één dag. Houd er rekening mee dat je externe systeem tijdig opnieuw moet authenticeren met de ReflexBlue Applicatie Server om een nieuw token op te halen zodra het oude niet meer geldig is.

Als een autorisatietoken is verlopen, krijg je bij een verzoek naar de Externe API van de ReflexBlue Applicatie Server een HTTP-statuscode 401 (Unauthorized) terug. Vraag in dat geval een nieuw token aan om verder te kunnen werken.

Navigatie

Zoeken

Geen resultaten.