Create Downloadable Product

Here’s the updated description with the additional clarification:

The 'Create Downloadable Product' endpoint allows users to add a new digital product to their store. This endpoint enables specifying product details, such as name, price, SKU, and download settings, to configure the product for digital delivery without shipping requirements. The process is the same as creating any other product, with the key distinction being the inclusion of 'product_class': 'downloadable' in the request payload. The response includes product metadata, availability, and stock settings relevant to digital products.

🔑Scopes

products.read_write - Products Read & Write

curl --location --request POST 'https://api.zid.sa/v1v1/products/' \ --header 'Store-Id: 3' \ --header 'Accept-Language: ar' \ --header 'X-manager-Token: eyJpdiI6ImNSZ0NKWXlMZ3hEcDZudU1wS3R1dVE9PSIsInZhbHVlIjoiZnRqdGRVUE1IdU9PaytvSk1pbGV5Zk5YUk9pRG9ONWVwa1NaTUIvN0JkYzgwNlFUV3h6ZCs5S2VkRDVaSy9GbWRDQm9adlR4SEFHMStpUDNuM1V1dG9PUENCZ0R6eHJYeEZHLzhzMFlWb25NMHI3TE1NZDIzbnNEQlI3ekNycE5RVHVBczQ2L1FKSjF1UTI3Q0xzaXNtcmM1Mi9LUHc3aDEvV0J6R2ZyUkJCT0lrbXg3c0NiN0JEL1RvWFlSSWZ4M1J2MVhiRWZZcUdXMGI3NVJlMXA0aFNlcE02Z1RPak43Ump6Z1BQdEpnMD0iLCJtYWMiOiIxZmU2YzlmYWE1NTE0OTQwNDFmMTkxYzdhNGM0Zjk2NDgyYjI4ZWM2NjlkODU3NTI4NzM1NTY0YmVkZjMxNzc5IiwidGFnIjoiIn0=:' \ --header 'Currency: SAR' \ --header 'Access-Token: eyJpdiI6ImNSZ0NKWXlMZ3hEcDZudU1wS3R1dVE9PSIsInZhbHVlIjoiZnRqdGRVUE1IdU9PaytvSk1pbGV5Zk5YUk9pRG9ONWVwa1NaTUIvN0JkYzgwNlFUV3h6ZCs5S2VkRDVaSy9GbWRDQm9adlR4SEFHMStpUDNuM1V1dG9PUENCZ0R6eHJYeEZHLzhzMFlWb25NMHI3TE1NZDIzbnNEQlI3ekNycE5RVHVBczQ2L1FKSjF1UTI3Q0xzaXNtcmM1Mi9LUHc3aDEvV0J6R2ZyUkJCT0lrbXg3c0NiN0JEL1RvWFlSSWZ4M1J2MVhiRWZZcUdXMGI3NVJlMXA0aFNlcE02Z1RPak43Ump6Z1BQdEpnMD0iLCJtYWMiOiIxZmU2YzlmYWE1NTE0OTQwNDFmMTkxYzdhNGM0Zjk2NDgyYjI4ZWM2NjlkODU3NTI4NzM1NTY0YmVkZjMxNzc5IiwidGFnIjoiIn0=:' \ --header 'Role: Manager' \ --header 'Authorization: eyJ0fXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIzIiwianRpIjoiMTQyZjEyYTVlY2JhNzIyZTZlMjkwZjVlZDRhNmEwZDk1N2M4MGM3ZTVhODE4MjMyMjhjMzk0YjkyMGFkMmQ2ZDFkODI2YTYxOTI3MTEwMzUiLCJpYXQiOjE3MTA5NzY3MDYuNzUwOTI0LCJuYmYiOjE3MTA5NzY3MDYuNzUwOTI3LCJleHAiOjE3NDI1MTI3MDYuNzA2OTc5LCJzdWIiOiIzIiwic2NvcGVzIjpbIioiXX0.k2xkXywMs4eFArabnVFPH2CfBdMT1M-x0i6xGxM_OfUqKpFRxlTxj7tapbuSKDa2e-lyVr9AZwuCidj-5v1WQjYgj_bYRE-bi4CvGgY9reSVRy5l5a7i19nXNWyDfYHc_20CgMwrAUVlJoZLUkrQ3O6dAdjo83aoyktTKKfI7Q3-iWdFPAEzby_1pU5T883whYEWwfXWGzICwDQzulQzLm7dSAOy2xUNdB2CHn0tHCNHeaY8Mx11MBABAw_RVPZddR7kDOf5jc1g6fJ9YYGeru1ptZPwK2vHlRLnVJdbN5f4byE77LEVyb3daWuv3sYeIdEV3eV9WLmeGt0FlOjxpTHpEqBN4t1np6vV5nZyoluP9SuDXt5wKI7o3uPhat8vZ4B8pc-35484Y5_RxHyP2fxgQStqLFvMypJGoLMh2zg39sUP3oI35R1bIadKt49MM2c-RjP-16ngbK6np104hdFYojelf9EFRN9tY-yIUEyg5fWLw6mIBOxDFcqjZRUc-3P5VPgdeacp0-oU968YB1gP3155Dsu8DVxDr-iuQ5deusTpYnFlqokJ26VknHRJSMxlVBWptljv9EHNFw6a5gvcj8xht5ldm4b9RqisxUC0OlwJtK_pmhp-srp6biaj54u9zIvjKd-seJNumF1VM2nfJk63TnfPZbG9SLyPjuU' \ --header 'Content-Type: application/json' \ --data-raw '{ "name": { "ar": "منتج قابل للتنزيل", "en": "downloadable product" }, "price": 2, "is_draft": true, "product_class": "downloadable" }'

{ "id": "5af835b7-1a37-4401-a3fc-6d9007c44c8f", "product_class": "downloadable", "sku": "Z.484979.17300084114100137", "barcode": "", "parent_id": null, "name": { "ar": "downloadable product" }, "slug": "downloadable-product", "price": 2, "short_description": null, "sale_price": null, "formatted_price": "2.00 ر.س ", "formatted_sale_price": null, "currency": "SAR", "currency_symbol": " ر.س ", "attributes": [], "categories": [], "display_order": null, "has_options": false, "has_fields": false, "images": [], "is_draft": false, "quantity": null, "is_infinite": true, "html_url": "https://j1wfge.zid.store/products/downloadable-product", "weight": { "value": null, "unit": "kg" }, "keywords": [], "requires_shipping": false, "is_taxable": true, "structure": "standalone", "seo": null, "rating": { "average": 0, "total_count": 0, "1_ratings": { "percentage": 0, "count": 0 }, "2_ratings": { "percentage": 0, "count": 0 }, "3_ratings": { "percentage": 0, "count": 0 }, "4_ratings": { "percentage": 0, "count": 0 }, "5_ratings": { "percentage": 0, "count": 0 } }, "store_id": 484979, "purchase_restrictions": { "min_quantity_per_cart": null, "max_quantity_per_cart": null, "availability_period_start": null, "availability_period_end": null, "sale_price_period_start": null, "sale_price_period_end": null }, "metafields": null, "meta": { "download_limit": null, "expiration_period": null }, "related_products_settings": "AUTO_GENERATED", "related_products_title": null, "badge": null, "variants": [], "cost": null, "is_published": true, "waiting_customers_count": null, "description": null, "custom_user_input_fields": [], "custom_option_fields": [], "options": [], "related_products": [], "next_product": null, "previous_product": null, "group_products": null, "stocks": [ { "id": "36173f2b-f412-4b48-89bd-43d7733daf80", "location": { "id": "4e67872b-3483-4615-8fec-0cc4f9efc064", "name": { "ar": "المخزون الأساسي" }, "type": "PHYSICAL", "full_address": "RGRB7496, 7496 Al Raht, 3901، حي الرحمانية، Riyadh 12341, Saudi Arabia" }, "available_quantity": null, "is_infinite": true } ], "sold_products_count": null, "created_at": "2024-10-27T05:53:31.411987Z", "updated_at": "2024-10-27T05:53:31.412015Z" }

Request

Header Params

Store-Id

integer

optional

Unique identifier of the store.

Example:

Accept-Language

string

optional

Preferred language for the response. Defaults to en if not specified.

Example:

X-manager-Token

string

optional

This token is used to authenticate and access information related to the store. It is obtained through an OAuth mechanism and is required to perform operations on the store's data. The X-Manager-Token should be included in the header of API requests that require store-related information.

Example:

eyJpdiI6ImNSZ0NKWXlMZ3hEcDZudU1wS3R1dVE9PSIsInZhbHVlIjoiZnRqdGRVUE1IdU9PaytvSk1pbGV5Zk5YUk9pRG9ONWVwa1NaTUIvN0JkYzgwNlFUV3h6ZCs5S2VkRDVaSy9GbWRDQm9adlR4SEFHMStpUDNuM1V1dG9PUENCZ0R6eHJYeEZHLzhzMFlWb25NMHI3TE1NZDIzbnNEQlI3ekNycE5RVHVBczQ2L1FKSjF1UTI3Q0xzaXNtcmM1Mi9LUHc3aDEvV0J6R2ZyUkJCT0lrbXg3c0NiN0JEL1RvWFlSSWZ4M1J2MVhiRWZZcUdXMGI3NVJlMXA0aFNlcE02Z1RPak43Ump6Z1BQdEpnMD0iLCJtYWMiOiIxZmU2YzlmYWE1NTE0OTQwNDFmMTkxYzdhNGM0Zjk2NDgyYjI4ZWM2NjlkODU3NTI4NzM1NTY0YmVkZjMxNzc5IiwidGFnIjoiIn0=:

Currency

string

optional

The currency in which the data should be returned. This should be provided as an ISO 4217 currency code. For example, SAR for Saudi Riyal, USD for United States Dollar, KWD for Kuwaiti Dinar, etc.

Example:

SAR

Access-Token

string

optional

An Access Token is a unique string that represents the authorization granted to a client (Partner application) by a user (Merchant or Store Manager) to access their protected resources. It is part of the OAuth 2.0 standard and is used to authenticate API requests on behalf of the user. Access Tokens have a limited lifespan and must be used within their validity period. Once expired, a new Access Token can be obtained using a Refresh Token. Access Tokens should be treated as sensitive information and must be kept secure to prevent unauthorized access to the user's data. If you do not have an Access-Token, but have the older alternative instead, i.e., the X-Manager-Token, then see the instructions here on how to obtain the Access-Token.

Example:

Role

string

optional

Role of the user.

Example:

Manager

Authorization

string

optional

The Authorization token is a unique key given to the third-party application (Partner) by Zid. It is used to authenticate the API requests made by the Partner application. The token verifies the partner's identity and ensures they have permission to access Zid's API but does not provide any specific user or store information. It should be included in the header of API requests when the partner application needs to access Zid's API.

Example:

eyJ0fXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIzIiwianRpIjoiMTQyZjEyYTVlY2JhNzIyZTZlMjkwZjVlZDRhNmEwZDk1N2M4MGM3ZTVhODE4MjMyMjhjMzk0YjkyMGFkMmQ2ZDFkODI2YTYxOTI3MTEwMzUiLCJpYXQiOjE3MTA5NzY3MDYuNzUwOTI0LCJuYmYiOjE3MTA5NzY3MDYuNzUwOTI3LCJleHAiOjE3NDI1MTI3MDYuNzA2OTc5LCJzdWIiOiIzIiwic2NvcGVzIjpbIioiXX0.k2xkXywMs4eFArabnVFPH2CfBdMT1M-x0i6xGxM_OfUqKpFRxlTxj7tapbuSKDa2e-lyVr9AZwuCidj-5v1WQjYgj_bYRE-bi4CvGgY9reSVRy5l5a7i19nXNWyDfYHc_20CgMwrAUVlJoZLUkrQ3O6dAdjo83aoyktTKKfI7Q3-iWdFPAEzby_1pU5T883whYEWwfXWGzICwDQzulQzLm7dSAOy2xUNdB2CHn0tHCNHeaY8Mx11MBABAw_RVPZddR7kDOf5jc1g6fJ9YYGeru1ptZPwK2vHlRLnVJdbN5f4byE77LEVyb3daWuv3sYeIdEV3eV9WLmeGt0FlOjxpTHpEqBN4t1np6vV5nZyoluP9SuDXt5wKI7o3uPhat8vZ4B8pc-35484Y5_RxHyP2fxgQStqLFvMypJGoLMh2zg39sUP3oI35R1bIadKt49MM2c-RjP-16ngbK6np104hdFYojelf9EFRN9tY-yIUEyg5fWLw6mIBOxDFcqjZRUc-3P5VPgdeacp0-oU968YB1gP3155Dsu8DVxDr-iuQ5deusTpYnFlqokJ26VknHRJSMxlVBWptljv9EHNFw6a5gvcj8xht5ldm4b9RqisxUC0OlwJtK_pmhp-srp6biaj54u9zIvjKd-seJNumF1VM2nfJk63TnfPZbG9SLyPjuU

Body Params application/json

name

object

required

Product name object.

string

required

Name in Arabic.

Example:

منتج قابل للتنزيل

string

required

Name in English.

Example:

downloadable product

price

integer

required

The regular price of the product.

Example:

is_draft

boolean

required

Indicates whether the product is in a draft state.

Default:

true

product_class

string

required

Specifies the type of product.

Example:

downloadable

Examples

Responses

🟢200Success

application/json

Body

string

required

Unique identifier for the product.

Example:

5af835b7-1a37-4401-a3fc-6d9007c44c8f

product_class

string

required

Specifies the type of product.

Example:

downloadable

sku

string

required

Stock Keeping Unit.

Example:

Z.484979.17300084114100137

barcode

string

required

Barcode assigned to the product.

Example:

[]

parent_id

null

required

Identifier for the parent product.

name

object

required

Product name object.

string

required

Name in Arabic.

Example:

downloadable product

slug

string

required

A URL-friendly identifier for the product.

Example:

downloadable-product

price

integer

required

The regular price of the product.

Example:

short_description

null

required

A brief description of the product.

sale_price

null

required

Discounted price for the product if applicable.

formatted_price

string

required

The formatted display of the product’s price including currency symbol.

Example:

2.00 ر.س

formatted_sale_price

null

required

Display for the sale price with currency symbol.

currency

string

required

Currency code for the product’s price.

Example:

SAR

currency_symbol

string

required

Symbol for the currency.

Example:

ر.س

attributes

array[string]

required

Array containing custom attributes associated with the product.