Create Product API now supports an idempotency key

资料正文

§1 Create Product API now supports an idempotency key

§2 Summary

Summary

The Create Product endpoint now supports an idempotency key. This can help duplicate products being created when an API call is retried with the same parameters. We recommend that you generate v4 UUIDs for use as keys with a maximum length of 128 characters.

§3 Change Details

Change Details

A new key named idempotency_key can now be supplied in the body of the Create Product request so that you can prevent duplicate products being created whenever the API request is retried. It is a unique key to recognize a request and prevent duplicate processing of the same request, especially in cases of connection issues. Ensure this key is unique within the shop for each request to avoid accidental duplicates. It can be used to track requests across the shop. Maximum length is 128 characters. Note: We recommend that you generate v4 UUIDs for use as keys. There are no changes to the responses and error messages.

§4 Required Actions

Required Actions

If you experience issues where the retry logic creates duplicate products, it is highly recommended you adopt this change.

§5 Markets and Versions

Markets and Versions

This change applies to all markets and v202309 of Create Product.