Guides

Step 3: Import Assets

There are two primary methods for importing digital assets into PDX:

Method A: URL-Based Import (Recommended)

Include a publicly accessible URL within a standard attribute.

Workflow:

After the initial import, convert the attribute's base type to "Asset" within PDX Profile and account settings > Account > Master data configuration screen.

https://pdx.stibosystems.com/#/settings/master-data/attributes

PDX will then download and store the assets locally for all current and future URLs populated on this attribute field.

Example Payload:

POST /api/import/v1/feeds/master

{
  "products": [
    {
      "__ID": "WIDGET-100",
      "Main_Image_URL": "https://external-site.com/images/widget-100.jpg"
    }
  ]
}

Method B: Binary Asset Import

Link the binary to the product via an assetId.

  1. Product Payload: Include the assetId in a product attribute set to base type "Asset".
  2. Binary Upload: Call the Asset Upload endpoint using the same ID.

Example Product Payload:

POST /api/import/v1/feeds/master

{
  "products": [
    {
      "__ID": "WIDGET-100",
      "Product_Icon": "myTestImage"
    }
  ]
}

Example Asset Upload:

POST /api/asset/v1/assets/upload?assetId=assetIdHere

curl --location 'http://pdx.stibosystems.com/api/asset/v1/assets/upload?assetId=assetIdHere'
--header 'Authorization: auth here'
--form 'file=@"/Users/Pictures/100x300-Bottles.jpg"'