The Zuora API supports idempotency that prevents the same operation from being performed multiple times by accident. For example, when you attempt to create a product using the Create a product operation but no response is returned because of the network issue, you can retry the request using the same idempotency key to ensure that only one product is created.
To perform an idempotent request, provide an additional
idempotency-key header in the request. This idempotency key should be a unique value and the Zuora server identifies subsequent retries of the same request using this value. The value should be less than 255 characters long.
When you submit a request with the
idempotency-key specified, the resulting status code, headers, and the body of this request is saved regardless of whether it succeeded or failed. Subsequent requests with the same key return the same result. A created idempotency key is automatically removed from the system 24 hours after it is set.
PATCH requests accept idempotency keys. Because the
DELETE requests are intrinsically idempotent, you should not specify the
idempotency-key header in these requests.
Note that the following HTTP status codes are specific to using the