Hoe log ik in op de Client API van Twelve?

Lees dit wanneer je de Client API wilt gebruiken om bestellingen of klantgegevens te beheren. Let op aan deze API-koppeling kunnen extra kosten verbonden zijn. 

Volg dit stapsgewijs om in te loggen:

1. Ontvang inloggegevens
   Je hebt van Twelve een URL, public API-key en één of meerdere klantennummers gekregen. Heb je deze nog niet? Neem dan contact op met support.

2. Genereer de private API-key

   • Stuur een POST naar https://orderapi.twelve.eu/api/v1/Registration.

   • Dit is een eenmalige call.

   • Bij verlies kun je support vragen je public key opnieuw in te stellen.

3. Voer PublicAPIkey in header in

   • Voeg bij je API-call de header PublicAPIkey toe met je public key.

4. Opslag ‘sharedSecret’

   • Na de registratie ontvang je een sharedSecret in het response: bewaar dit veilig.

5. Genereer request token

   • Maak een willekeurige string: Math.random().toString(36).replace(/[^a-z]+/g, ''). Doe dit voor elke API-call opnieuw.

6. Bereken SHA256-signature

   • Gebruik: SHA256(path + request_token + Private_API_key).

   • Bijvoorbeeld in Postman:

     CryptoJS.SHA256(path + pm.variables.get("request_token") + pm.variables.get("Private_API_key_order"))


7. Gebruik signature in headers

   • Voeg toe aan header: Request-Signature met de berekende hash.

8. Klantnummer toevoegen

   • Zet in de header ClientID het klantnummer van de gegevens die je wilt opvragen of aanpassen.

📌 FAQ 

Wat als ik de registratie‑endpoint niet kan bereiken?
Controleer je netwerk of proxy-instellingen.

Ik krijg een foutmelding over de signature?
Controleer of je request_token, Private API-key en path exact zijn zoals bij de berekening. Hoofdletters en onderstreping tellen mee.

Kan ik dit automatiseren in Postman of code?
Ja. Gebruik variabelen voor request_token en Private_API-key; configureer een pre‑request script om de signature vooraf te berekenen.