Hoe werkt de API-koppeling van Twelve?

Lees dit artikel als je wilt begrijpen wat een API-koppeling van Twelve precies inhoudt: wat een
API is, hoe deze werkt, en hoe je ermee aan de slag kunt.

⚙️ Benodigdheden

Geen specifieke technische vereisten vooraf—maar je hebt wel toegang nodig tot de API-documentatie of je ontvangt een public API-sleutel van Twelve om te kunnen inloggen.

🔌 Stappenplan

Hieronder ontdek je in duidelijke stappen wat een API-koppeling is en hoe deze werkt:

1. Wat is een API-koppeling?

Een API (Application Programming Interface).
Het is software waarmee twee applicaties met elkaar kunnen communiceren. API’s zijn een toegankelijke manier om gegevens binnen en tussen organisaties te extraheren en te delen.
Een API-koppeling zorgt voor communicatie tussen meerdere softwareprogramma’s of applicaties. Zelfs als deze in verschillende programmeertalen geschreven zijn.

2. Hoe werkt het technisch?

Een API fungeert als een tussenlaag: van buitenaf kun je aanvragen (requests) doen via een stukje code dat onderdeel is van het systeem.
De API vertaalt deze aanvragen en stuurt ze door naar de achterliggende server. Die server genereert vervolgens een antwoord (response) met de benodigde data, die weer via de API bij de aanvrager terugkomt.
Een voorbeeld: een website die vakantiedeals vergelijkt haalt met behulp van API’s up‑to‑date prijzen op bij externe aanbieders.

3. Over de Order API van Twelve

Je krijgt van Twelve een URL, public API key en klantnummer(s).
Met behulp van een 'Registration Call' genereer je een private API‑key—deze wordt maar één keer aangemaakt. Als je hem kwijt bent, moet Twelve de public key resetten.
Elke API-call vereist een unieke request token, berekend met een SHA‑256-hash op basis van het request‑pad, het token én de private API‑key. Dit zorgt voor een beveiligde signature.
Bij veel API-oproepen moet je ook je ClientID meesturen—behalve wanneer je een client-specific API-key gebruikt; dan wordt die automatisch herkend.

📌 FAQ

Werkt de API-koppeling niet zoals verwacht? Controleer dan:

Heb je toegang tot de juiste public API-key en klantennummer?
Is de private API-key correct gegenereerd via de registratie-aanroep?
Wordt bij elke oproep een nieuwe, unieke request token gebruikt?
Komt je request signature overeen met de SHA-256-hash van het pad + token + private key?
Heb je de juiste ClientID toegevoegd, indien nodig?