Products (Admin)

Products are one of the main entities of commerce system. They are the entity which describes exactly what are the collection and tokens that are being sold in your e-commerce.

You can create products that represents one entire collection or even represents one unique and specific token from your collection/contract. If you have one product that contains more than one token, you can also specify different prices depending on the token that you want to sell. See more in Public Products Page.

Products can have some kind of rules which specify if some user can purchase it or not or even the maximum amount of tokens and the time period that some user can purchase the token. This is specified by product order rules.

Product Model (Example)

{
    "id": "6368dfb5-f48c-48b1-be13-dd413548a558",
    "createdAt": "2022-10-17T21:47:12.505Z",
    "updatedAt": "2022-10-17T22:04:00.373Z",
    "companyId": "010e92ea-d3af-40d9-a19e-a263fdfe6e92",
    "name": "Test",
    "description": "block",
    "images": [
        {
            "thumb": "https://dummyimage.com/200x200/fff/000",
            "original": "https://dummyimage.com/600x400/fff/000"
        }
    ],
    "prices": [
        {
            "amount": "1.20",
            "currencyId": "8c43ece8-99b0-4877-aed3-2170d2deb4bf",
            "currency": {
                "id": "8c43ece8-99b0-4877-aed3-2170d2deb4bf",
                "createdAt": "2022-09-02T11:23:53.575Z",
                "updatedAt": "2022-09-02T11:23:53.575Z",
                "name": "USD",
                "crypto": false,
                "symbol": "US$",
                "code": "USD"
            }
        }
    ],
    "distributionType": "random",
    "pricingType": "product",
    "contractAddress": "0x5478a7790e45bb08213b9d7384bf50f65fc0a667",
    "chainId": 80001,
    "startSaleAt": null,
    "endSaleAt": null,
    "status": "published",
    "draftData": {
        "range": "1",
        "quantity": 1,
        "keyCollectionId": "2e90e88b-7263-4cdc-a9dd-b7cdf3df4c91"
    },
    "slug": "string",
    "tags": [],
}

Service Methods

Creates a product inside the company

Rest API reference:

post

Authorizations

bearerx-w3block-api-keyx-w3block-idx-w3block-secret

Path parameters

companyIdstringrequired

Body

tagsarray[]requiredExample: ["7ca74ed3-93ff-4df9-b8a0-8308c590174b"]

namestringrequiredExample: W3Block Product

descriptionstringrequiredExample: My Description

imagesobject[]optional

pricesobject[]required

distributionTypestring · enumrequiredExample: randomAvailable options:

pricingTypestring · enumrequiredExample: productAvailable options:

startSaleAtstring · date-timeoptional

endSaleAtstring · date-timeoptional

draftDataobjectrequired

slugstringoptional

htmlContentobjectoptionalExample: <b>block</b>

onDemandMintEnabledbooleanoptionalDefault: trueExample: true

requirementsobjectoptional

termsobject[] | nullableoptional

relevancenumberoptionalDefault: 0Example: 0

settingsobjectoptional

Responses

application/json

post

cURLJavaScriptPythonHTTP

curl -L \
  --request POST \
  --url 'https://commerce.w3block.io/admin/companies/{companyId}/products' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "tags": [
      "7ca74ed3-93ff-4df9-b8a0-8308c590174b"
    ],
    "name": "W3Block Product",
    "description": "My Description",
    "images": [
      {
        "assetId": "123e4567-e89b-12d3-a456-426614174000",
        "variants": [
          {
            "keyLabel": "text",
            "keyValue": "text"
          }
        ]
      }
    ],
    "prices": [
      {
        "currencyId": "65fe1119-6ec0-4b78-8d30-cb989914bdcb",
        "amount": "0.01"
      }
    ],
    "distributionType": "random",
    "pricingType": "product",
    "startSaleAt": null,
    "endSaleAt": null,
    "draftData": {
      "keyCollectionId": null,
      "range": null
    },
    "slug": "text",
    "htmlContent": "<b>block</b>",
    "onDemandMintEnabled": true,
    "requirements": {
      "companyId": "123e4567-e89b-12d3-a456-426614174000",
      "keyCollectionId": "123e4567-e89b-12d3-a456-426614174000",
      "productId": "123e4567-e89b-12d3-a456-426614174000",
      "requirementCTALabel": "text",
      "requirementDescription": "text",
      "requirementModalContent": "text",
      "requireKycContext": {
        "slug": "text"
      }
    },
    "terms": null,
    "relevance": 0,
    "settings": {
      "passShareCodeConfig": {
        "dataFields": [
          {
            "name": "text",
            "type": "text",
            "label": "text",
            "required": true
          }
        ],
        "enabled": true
      },
      "acceptMultipleCurrenciesPurchase": true
    }
  }'

201

401

201

{}

Lists all product of some company

Rest API reference:

get

Authorizations

bearerx-w3block-api-keyx-w3block-idx-w3block-secret

Path parameters

companyIdstringrequired

Query parameters

pagenumberoptionalDefault: 1

limitnumberoptionalDefault: 10

searchstringoptional

sortBystring · enumoptionalExample: createdAtAvailable options:

orderBystring · enumoptionalAvailable options:

sortByPriceCurrencyIdstring · uuid optional

includeMetadatabooleanoptional

Includes first product token found metadata for each product. (Works good if you want to get some common NFT metadata attributes that is applied for all contract tokens)

Default: falseExample: false

tagIdsstring[]optional

statusstring · enum[]optional

Responses

get

cURLJavaScriptPythonHTTP

curl -L \
  --url 'https://commerce.w3block.io/admin/companies/{companyId}/products' \
  --header 'Authorization: Bearer JWT'

200

401

200

No Content

Gets a company product by slug

Rest API reference:

get

Authorizations

bearerx-w3block-api-keyx-w3block-idx-w3block-secret

Path parameters

companyIdstringrequired

slugstringrequired

Responses

get

cURLJavaScriptPythonHTTP

curl -L \
  --url 'https://commerce.w3block.io/admin/companies/{companyId}/products/get-by-slug/{slug}' \
  --header 'Authorization: Bearer JWT'

200

401

200

No Content

Gets a company product by id

Rest API reference:

get

Authorizations

bearerx-w3block-api-keyx-w3block-idx-w3block-secret

Path parameters

productIdstringrequired

companyIdstringrequired

Responses

get

cURLJavaScriptPythonHTTP

curl -L \
  --url 'https://commerce.w3block.io/admin/companies/{companyId}/products/{productId}' \
  --header 'Authorization: Bearer JWT'

200

401

200

No Content

Updates some company product

You can't update tokens amount or collection from published product tokens. In a near future we are planning to offer that, but for a while, you will need to create a new one.

Rest API reference:

patch

Authorizations

bearerx-w3block-api-keyx-w3block-idx-w3block-secret

Path parameters

productIdstringrequired

companyIdstringrequired

Body

tagsarray[]optionalExample: ["7ca74ed3-93ff-4df9-b8a0-8308c590174b"]

namestringoptionalExample: W3Block Product

descriptionstringoptionalExample: My Description

imagesobject[]optional

pricesobject[]optional

distributionTypestring · enumoptionalExample: randomAvailable options:

pricingTypestring · enumoptionalExample: productAvailable options:

startSaleAtstring · date-timeoptional

endSaleAtstring · date-timeoptional

draftDataobjectoptional

slugstringoptional

htmlContentobjectoptionalExample: <b>block</b>

onDemandMintEnabledbooleanoptionalDefault: trueExample: true

requirementsobjectoptional

termsobject[] | nullableoptional

relevancenumberoptionalDefault: 0Example: 0

settingsobjectoptional

Responses

patch

cURLJavaScriptPythonHTTP

curl -L \
  --request PATCH \
  --url 'https://commerce.w3block.io/admin/companies/{companyId}/products/{productId}' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "tags": [
      "7ca74ed3-93ff-4df9-b8a0-8308c590174b"
    ],
    "name": "W3Block Product",
    "description": "My Description",
    "images": [
      {
        "assetId": "123e4567-e89b-12d3-a456-426614174000",
        "variants": [
          {
            "keyLabel": "text",
            "keyValue": "text"
          }
        ]
      }
    ],
    "prices": [
      {
        "currencyId": "65fe1119-6ec0-4b78-8d30-cb989914bdcb",
        "amount": "0.01"
      }
    ],
    "distributionType": "random",
    "pricingType": "product",
    "startSaleAt": null,
    "endSaleAt": null,
    "draftData": {
      "keyCollectionId": null,
      "range": null
    },
    "slug": "text",
    "htmlContent": "<b>block</b>",
    "onDemandMintEnabled": true,
    "requirements": {
      "companyId": "123e4567-e89b-12d3-a456-426614174000",
      "keyCollectionId": "123e4567-e89b-12d3-a456-426614174000",
      "productId": "123e4567-e89b-12d3-a456-426614174000",
      "requirementCTALabel": "text",
      "requirementDescription": "text",
      "requirementModalContent": "text",
      "requireKycContext": {
        "slug": "text"
      }
    },
    "terms": null,
    "relevance": 0,
    "settings": {
      "passShareCodeConfig": {
        "dataFields": [
          {
            "name": "text",
            "type": "text",
            "label": "text",
            "required": true
          }
        ],
        "enabled": true
      },
      "acceptMultipleCurrenciesPurchase": true
    }
  }'

200

401

200

No Content

Publish a company product

Only published products can be purchased because is this endpoint that gets the permission of transfer and all other things about blockchain tokens informations.

Rest API reference:

patch

Authorizations

bearerx-w3block-api-keyx-w3block-idx-w3block-secret

Path parameters

productIdstringrequired

companyIdstringrequired

Responses

patch

cURLJavaScriptPythonHTTP

curl -L \
  --request PATCH \
  --url 'https://commerce.w3block.io/admin/companies/{companyId}/products/{productId}/publish' \
  --header 'Authorization: Bearer JWT'

200

401

200

No Content