The Product Submissions API is used for adding products to the Zalando Catalog. Use the Product Submissions API to submit a product submission JSON file to the zDirect API.
To use the Product Submissions API, your client must have the
Many zDirect APIs require clients to have specific permissions or scopes for read or write access. You may assign scopes to your apps in the "Applications" section of the zDirect Portal.
For more information on configuring app scopes, see the Applications section of our zDirect Portal guide.
Each app may only make the following number of requests per second:
For more information, see Rate Limiting.
When you submit a product submission JSON using the Product Submissions API in the sandbox environment, the JSON will be subjected to the same automated validation as in the production environment.
This validation checks that the submission is a valid JSON (that is, no missing or illegal characters), and that all required attribute types are defined.
If you receive an http
200 code when submitting a JSON to the sandbox, you may be confident that the basic structure and content is correct.
During actual submission in the product environment, additional rounds of manual and automated validation are applied to verify that your attribute definitions are not just valid, but correct, as-intended, and so forth. We cannot provide that level of validation in the sandbox environment, unfortunately.
Product submissions made in the sandbox environment are never persisted or propagated. You will not, for example, be able to view sandbox submissions in your Product Status Report.
For more information, see Sandbox Testing in our Getting Started Guide.
- For detailed instructions on products and product onboarding, see Products and Product Onboarding in our Developer Guide.
- For instructions on using the Products Submission API, see the Submission and Validation section of "Onboarding New Products" in our Developer Guide.
- For an OpenAPI reference, see OpenAPI Specification: Merchant Product Attributes API.