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.
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.
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
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.
The key can be a maximum of 255 characters
A key remains active for 24 hours
Only POST and PATCH use this function