Products (legacy)

Product resources are used to model a class of individual items, and as such should contain information common to all instances of that product. For example, a product resource could be used to describe a particular SKU or model of a physical product with specific characteristics including size, weight, color, market, GS1 identifiers etc.

Once created, each Thng that represents an individual instance of that product class is associated with the product resource containing the common information via its product field. Products are useful to store properties or other data items that are common to a set of Thngs (so you don't need to replicate the model name or weight for thousands of Thngs that are individual instances of the same product).

Like Thngs, products can have properties and actions associated with them. In addition to specifying a product in a generic action request, it is also possible to create an action through the product itself using aliased actions.

API Status General Availability: /products /products/:productId /products/:productIdentifier /products/:productId/actions/:actionType /products/:productId/properties

ProductDocument Data Model

An object representing a platform product.

.name (string, required)
    Friendly name of this resource.

.id (string, read-only)
    The ID of this resource.

.color (string)
    Color of the product itself

.createdAt (integer, read-only)
    Timestamp when the resource was created.

.updatedAt (integer, read-only)
    Timestamp when the resource was updated.

.activatedAt (integer, read-only)
    Timestamp when the product was activated.

.description (string)
    Friendly description of this resource.

.type (string)
    Type of this resource. Can be unset with an empty string.

.categories (array of string)
    An array of product categories as strings.

.photos (array of string)
    An array of product photo URLs as strings.

.url (string)
    The URL linking to the product information.

.identifiers (IdentifiersDocument)
    Various identifiers (EPC, GTIN, etc.) as a JSON object with 
    one or more key-value pairs. Identifiers which have keys 
    mentioned in account unique identifiers configuration will 
    be concatenated and used as unique identifier for a given 
    product which means that user will not be able to create 
    two products with the same unique identifiers.

.properties (object)
    A JSON object with key-value pairs describing properties of 
    the product.

.tags (array of string)
    Array of string tags associated with this resource.

.customFields (CustomFieldsDocument)
    Object of case-sensititve key-value pairs of custom fields 
    associated with the resource.

.fn (string, read-only)
    Friendly name of the product.

.brand (string)
    The product's brand name.

.scopes (ScopesDocument)
    Project and user scopes arrays.

See also: ScopesDocument

Filterable Fields

This resource type can be filtered using the following fields and operators.

Create a Product

Read a Product

When provided a productId, the Platform will return a single product document corresponding to that ID, if it exists.

Read all Products

Read all products in scope of the authenticating API key. The result may be paginated if there are more than 30 items.

Update a Product

Update a single product by ID.

Delete a Product

❗Danger!

Deleting a product resource will remove its product reference from all Thngs that point to it. This action cannot be reversed!

Update Multiple Products

Using a suitable filter, it is possible to apply (PUT) an updated ProductDocument to multiple products, providing they match the filter query parameter. For example, all products that begin with "Test" to contain the 'test' tag.

The update will be applied asynchronously, and the response will be 204 'No Content'.

Create a Product's Redirection

Use the appropriate short domain API to create a product redirection. This example uses tn.gg.

Read a Product's Redirection

Use the appropriate short domain redirection API to read a product redirection.

Update a Product's Redirection

Use the appropriate short domain redirection API and short ID to update a product redirection.

Delete a Product's Redirection