Idempotency
Our API supports idempotency, which allows you to safely resend a request without accidentally performing the same operation twice.
Our idempotency feature easily prevents an order from being sent twice to the same address or person (within 24 hours). This also means that it is no longer necessary to deduplicate your file if you use idempotency keys.
How does the idempotency key work?
The API can recognize whether a request has been made before by including a unique code (idempotency-key) in your request.
For example: you use the postcode and house number to generate an idempotency key. If our system receives two orders with the same address (the same key), only the first order is executed.
How to use it:
Create a unique key (e.g., a customer ID, order number, combination of postcode + house number, or a UUID)
Add this key to your request header:
Idempotency-Key: <unique key>Send your request as you did before
One key per request
An idempotency key is linked to the content of the request. If you try to send a second request with the same key but with a different body, you will receive an error message. Therefore, use a new key for each new request.
Important to remember
The key can be a maximum of 255 characters
A key remains active for 24 hours
Only
POSTandPATCHuse this function