Using Quable PIM API

There's just a few more things to know before you being using the Quable PIM API.

Reference Guide

This guide uses the same data model and writing convention to explain and demonstrate using the Quable PIM API.

Data Model

The data model is composed of:

  • Documents - Two main document types, Model & ModelColor.

  • Variants - For size linked to ModelColor via "variants".

  • Bundle - Enabled via another document type, Look, linked to ModelColor by the "look-modelcolor" LinkType

  • Assets - Linked to Model Color via the "modelcolor-media" LinkType and Look via the "look-media" LinkType.

  • Cross-sell - Enabled via a simple cross-sell LinkType to/from ModelColor

Writing Convention

Values to be replaced are indicated in this documentation (definitions and examples) by double curly braces:

{{ value to replace }}

Data Sequencing

136When you're preparing to load data, it's likely to be interdependent with other data that must be loaded first.

For example:
  • A value loaded on a document may be dependent on predefined values (value list). The predefined values must be loaded before the document.
  • A document must be classified. The parent classification must therefore already exist.
  • A variant belongs to a document. The document must already exist.

Examples

  • Import ERP data into Quable PIM:
2717
  • Import assets into Quable PIM:
2332
  • Export from Quable PIM to e-commerce site:
2442

DateTime Values

279DateTime values are expressed as UTC (equivalent to an offset of +00:00) in the format "yyyy-mm-dd hh:mm:ss" in filters or response body:

  • The hidden timezone designator is always Z.
  • The hours component must be specified as two digits in 24-hour format.
Example
The date 30 Dec 2001 9:30:00AM UTC is formatted as 2001-12-30 09:30:00.

Asset Download & Resizing

517When retrieving assets (via the API or a CSV Export) to download, URLs for the asset (rather than just the name) must be used in the request. You can specify original or you can request a specific size (e.g. 600x600) in the URL. (see examples)

🚧

Icons are displayed in the place of a preview image fin the interface or certain formats .

Examples

Image asset

  • The links > rel:thumbnail node contains:

    "https://cdn.quable.com/{{YOUR-PIM}}/CDI_VPF/600x600/cdi_vpf-png.png".

    If you need a size other than 600x600, your scripts can request a different size.

  • The links > rel:source node contains:

    "https://cdn.quable.com/{{YOUR-PIM}}/CDI_VPF/original/cdi_vpf-png.png".

    The original keyword indicates that Quable will return the orignal binary file that was uploaded or imported.
{
      "id": 62987,
      "name": "Black dress - Detail",
      "code": "CDI_VPF",
      "type": "image/png",
      "active": true,
      "created_at": "2020-12-10 11:06:55",
      "updated_at": "2020-12-21 15:57:45",
      "source": "CDI_VPF.png",
      "links": [
          {
              "rel": "self",
              "href": "https://{{YOUR-PIM}}.quable.com/api_1.php/medias/62987"
          },
          {
              "rel": "thumbnail",
              "href": "https://cdn.quable.com/{{YOUR-PIM}}/CDI_VPF/600x600/cdi_vpf-png.png"
          },
          {
              "rel": "source",
              "href": "https://cdn.quable.com/{{YOUR-PIM}}/CDI_VPF/original/CDI_VPF.png"
          }
      ]
  }
  • Video asset
    • The links > rel:thumbnail node contains:

      "https://cdn.quable.com/{{YOUR-PIM}}/CDI_VPF/600x600//bd_video-mp4.jpg".

      If you need a size other than 600x600, your scripts can request a different size.

    • The links > rel:source node contains:

      "https://cdn.quable.com/{{YOUR-PIM}}/CDI_VPF/original/bd_video.mp4".

      The original keyword indicates that Quable will return the orignal binary file that was uploaded or imported.

{
      "id": 675757,
      "name": "Black dress - Video",
      "code": "bd_video",
      "type": "video/mp4",
      "active": true,
      "created_at": "2020-12-10 11:06:55",
      "updated_at": "2020-12-21 15:57:45",
      "source": "bd_video.png",
      "links": [
          {
              "rel": "self",
              "href": "https://{{YOUR-PIM}}.quable.com/api_1.php/assets/bd_video"
          },
          {
              "rel": "thumbnail",
              "href": "https://cdn.quable.com/{{YOUR-PIM}}/CDI_VPF/600x600/bd_video-mp4.jpg"
          },
          {
              "rel": "source",
              "href": "https://cdn.quable.com/{{YOUR-PIM}}/CDI_VPF/original/bd_video.mp4"
          }
      ]
  }

❗️

Live usage

It is strictly forbidden to use the URLs of assets outside of Quable tools and solutions, typically beyond the PIM and DAM. You must download binaries of the assets before any use on an any other platform. The URL provided by Quable PIM is a download link, not a use link.

If you need a CDN (Content Delivery Network) feature in order to use these URLs on live environments or you need other resizing options, please contact the Quable PIM sales team.