This guide outlines the requirements and recommended steps to integrate the ZOOMstudio One-Click API. This integration allows users to instantly generate Smart Layout presentations or catalogs from a single product or a collection of products directly on your website.

• Step 1 - Create/Validate the account, at less once.
  • Existing accounts will be validate.
  • New accounts will be created.
• Step 2 - Authenticate for OneClick
• Step 3 - Create New Design

Notice: To Edit a design, see the section “How to edit a design?”

Step 1: Validate Account

Users who have logged in to your website will expect to be able to follow your ZOOMcatalog link without logging in a second time. If a user does not have an existing ZOOMcatalog account, they will be automatically registered.

How to do it?

1. Authorize a user on your own website (e.g., have the user log in with an email and password).
2. Use the authorize API endpoint to retrieve an user_token.

curl --location 'https://api.zoomcatalog.com/auth/authorize' \
--header 'Content-Type: application/json' \
--data-raw '{
    "grant_type": "authorization_code",
    "client_id": "<client-id>",
    "client_secret":"client-secret",
    "for_username": "[email protected]"
}'

Notice: The registration token, will be not need it for OneClick interaction.

Step 2: Authentication

To make a successful request, a valid user token is required for the user who has been auto-logged in (step 1). To get the valid user token, you need to make a request to the auth endpoint.