REST web service interface

GET products/{id}

Updated, 2012-06-19 14:28

Returns the details of a product

Resource Information

Rate Limited? No
Authentication Optional
Response Formats json,xml
HTTP Methods GET
Response Object Product

Resource URL

https://ecommerce.dexero.com/service/rest/2/merchant/catalog/products/{id}.format

Parameters

Parameter Description
id The system identification number or identifier defined by user.
Example Values : 302
locale Language
Example Values : fr,en
image_size Size of the returned Image
Example Values : 80 , 80x90

Example Request

https://ecommerce.dexero.com/service/rest/2/merchand/catalogue/products/15609.json

Example Response

XML JSON 
{
  "product" : {
    "id" : 15609,
    "sku" : "adsa",
    "identifier" : "eheheh",
    "name" : "hehehe",
    "currency" : "CAD",
    "type" : "grouped",
    "price" : "0.00",
    "rebate_price" : "0.00",
    "is_active" : true,
    "is_buyable" : false,
    "is_shippable" : false,
    "is_featured_new" : false,
    "weight" : 0,
    "length" : 0,
    "width" : 0,
    "height" : 0,
    "in_promotion" : false,
    "parent_product_id" : 0,
    "is_managed_inventory" : false,
    "number_remaining" : 0,
    "number_sold" : 0
  }
}

Response Object "Product"

Field Data Type Description
id long The unique identification number of this product. The ID is automatically generated and can not be changed.
sku string Stock Keeping Unit ( SKU ) .
identifier string The unique identification number of the product defined by a user.
name string Product name
description_short string The short description of the product which does not contain HTML formatting.
description_full text The long description of the product, which may include HTML formatting.
type enum('regular', 'donation','grouped', 'bundle','download','event') Product Type :
  • regular - physical commodity
  • donation - Product donation types
  • grouped - Grouped products
  • bundle - collection of configurable products
  • event - Product available for events
price decimal(20,2) Le prix du produit
rebate_price decimal(20,2) Product price calculated with discount
is_buyable boolean> Availability of the product purchase
is_active boolean Determines whether the product is active
is_shippable boolean Determines whether the product should be shipped.
is_featured_new boolean Determines whether the product is considered new
is_managed_inventory boolean Determines whether the inventory management is enabled
weight float(7,4) Weight of the product that can be used when calculating shipping costs
length float(7,4) Length of product that can be used when calculating shipping.
width float(7,4) Width of the product that can be used when calculating shipping.
height float(7,4) Height of product that can be used when calculating shipping.
in_promotion boolean Determines whether the product is currently in promotion
image string Main product image
parent_product_id long ID of the parent product
child_products array A product table identifiers for which the product is the parent
number_remaining int The remaining amount of product inventory
number_sold int The total number of times this item has been sold.
categories array A table of identifiers of the product categories that relate
attributes List<Attribute> A table of complementary product attributes

Response Object "Attribute"

Field Data Type Description
id long The unique identification number of the attribute. The ID is automatically generated and can not be changed.
identifier string The unique identifier for this attribute defined by a user.
label string The label of the attribute
type string The type attribute :
  • DateTime
  • Decimal
  • Long
  • Text
  • Varchar
cross_linked boolean Related to the products of the same level.
attributes List<Value> The values ​​of the attribute

Response Object "Value"

Field Data Type Description
id long The unique identifier of the attribute value. The ID is automatically generated and can not be changed.
value string The value of the attribute