Catalog
Introduction
Through the endpoints included in the Catalog section, you will be able to:
Retrieve all the available products
Get information about the products' variants
Retrieve information about the options available for a specific store (corresponding to a determined printing/fulfillment location i.e. North America or Europe)
Endpoints
Products
This API endpoint retrieves a list of all available products.
Authorizations
Responses
200
Request completed successfully.
application/json
401
Unauthorized
get
GET /api/beta/products HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*
{
"data": [
{
"id": 2,
"name": "Canvas",
"variants": 64,
"sku": "CVS",
"dpi": 36,
"type": "PRINT",
"images": [
{
"id": 1,
"original": "https://dummyimage.com/4000x3000/fff/000&text=api.merchone.com",
"thumb": "https://dummyimage.com/400x300/fff/000&text=api.merchone.com"
}
]
},
{
"id": 4,
"name": "Magic Mug",
"variants": 5,
"sku": "MGM",
"dpi": 72,
"type": "PRINT",
"images": [
{
"id": 2,
"original": "https://dummyimage.com/4000x3000/fff/000&text=api.merchone.com",
"thumb": "https://dummyimage.com/400x300/fff/000&text=api.merchone.com"
}
]
}
]
}
Product's variants
This API endpoint retrieves a list of all available product's variants.
Authorizations
Path parameters
product_idinteger · int64Required
ID of product to return
Responses
200
Request completed successfully.
application/json
401
Unauthorized
422
Unprocessable entity
application/json
get
GET /api/beta/products/{product_id} HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*
{
"data": [
{
"id": 30,
"code": "QUAD-100X100-1",
"variant_id": 30,
"variant_code": "QUAD-100X100-1",
"sku": "1001001",
"name": "100x100 cm",
"printfile": {
"format_width": 1000,
"format_height": 1000
},
"price": 29.8,
"price_details": {
"currency": "EUR",
"formatted": "29.09 €",
"in_subunit": 298
},
"shipping_countries": [
276,
826,
246
],
"options": {
"1": {
"name": "Canvas border",
"description": null,
"image": null,
"is_required": true,
"values": [
{
"id": 1,
"name": "Mirrored",
"sku": "",
"image": null,
"price": 0,
"price_details": {
"currency": "EUR",
"formatted": "29.09 €",
"in_subunit": 298
}
}
]
}
}
}
]
}
Variant's options
SKU's variant options
Last updated