API del catálogo de Printful

Printful cuenta con un importante catálogo de Productos y Variantes. Un producto puede describir un tipo, modelo y fabricante del artículo, mientras que la variante especifica los atributos más detallados del producto, como el color y tamaño exacto de una camiseta o las dimensiones de un póster. Además, cada artículo del Catálogo de Printful tiene un ID de variante único. Al configurar los Productos sincronizados o pedidos, necesitarás especificar el ID de variante o especificar el artículo, por lo tanto puedes utilizar este recurso API para encontrar el ID de variante necesario.

Es muy importante hacer referencia siempre al ID de variante (NO al ID de producto) al crear un pedido. Mezclar y utilizar el ID de producto en lugar del ID de variante puede desembocar en un pedido totalmente diferente. La entidad Producto solo sirve para permitir una búsqueda más fácil de lo que Printful ofrece.

También puedes utilizar este recurso API para encontrar los tipos de archivos de impresión para los que se puede configurar un producto, además del precio adicional que costaría cada impresión (por ejemplo, la impresión trasera o impresión de la etiqueta interior para camisetas). Además, algunos productos permiten opciones adicionales (por ejemplo el tipo de bordado y los colores del hilo). Estas opciones también se listan en las respuestas.

Get all Product list

GET https://api.printful.com/products

Returns list of Products available in the Printful.
Parámetros de entrada
Ninguno
Formato de respuesta:
code integer Código del estado de respuesta 200
result Product [ ]
id integer Product ID
type string Product type identifier
brand string Brand name
model string Model name
image string URL of a sample image for this product
variant_count integer Number of available variants for this product
currency string Currency in which prices are returned
files FileType [ ] Definitions of Print/Mockup file categories that can be attached to this product
id string Deprecated file type identifier. Please use type field instead!
type string File type identifier - use this to specify a file's purpose when creating an order
title string Display name
additional_price string Additional price when this print file type is used
options OptionType [ ] Definitions of additional options that are available for this product
id string Option identifier - use this to specify the option when creating an order
title string Display name
type string Data type of this option (currently only 'bool' is supported)
values array Option values - [key, value] map
additional_price string Additional price when this option is used
additional_price_breakdown array Additional price breakdown by type - [key, value] map
is_discontinued boolean If product is disabled in push
description string Product description
Clave API
Ejecutar

Get information about Variant

GET https://api.printful.com/products/variant/{id}

Returns information about a specific Variant and its Product
Parámetros de entrada
id integer Variant ID
Formato de respuesta:
code integer Código del estado de respuesta 200
result VariantInfo
variant Variant Information about the selected Variant
id integer Variant ID, use this to specify the product when creating orders
product_id integer ID of the product that this variant belongs to
name string Display name
size string Item size
color string Item color
color_code string Hexadecimal RGB color code. May not exactly reflect the real-world color
color_code2 string Secondary hexadecimal RGB color code. May not exactly reflect the real-world color
image string URL of a preview image for this variant
price string Variant's price (can change depending on print files and optional settings)
in_stock boolean Stock availability of this variant
availability_regions array Map of [region code, region name] of regions where the variant is available for fulfilment
product Product Information about the Product that the Variant belongs to
id integer Product ID
type string Product type identifier
brand string Brand name
model string Model name
image string URL of a sample image for this product
variant_count integer Number of available variants for this product
currency string Currency in which prices are returned
files FileType [ ] Definitions of Print/Mockup file categories that can be attached to this product
id string Deprecated file type identifier. Please use type field instead!
type string File type identifier - use this to specify a file's purpose when creating an order
title string Display name
additional_price string Additional price when this print file type is used
options OptionType [ ] Definitions of additional options that are available for this product
id string Option identifier - use this to specify the option when creating an order
title string Display name
type string Data type of this option (currently only 'bool' is supported)
values array Option values - [key, value] map
additional_price string Additional price when this option is used
additional_price_breakdown array Additional price breakdown by type - [key, value] map
is_discontinued boolean If product is disabled in push
description string Product description
Clave API
id Variant ID
Ejecutar

Get Product's Variant list

GET https://api.printful.com/products/{id}

Returns information about a specific product and a list of variants for this product.
Parámetros de entrada
id integer Product ID
Formato de respuesta:
code integer Código del estado de respuesta 200
result ProductInfo
product Product Information about the selected product
id integer Product ID
type string Product type identifier
brand string Brand name
model string Model name
image string URL of a sample image for this product
variant_count integer Number of available variants for this product
currency string Currency in which prices are returned
files FileType [ ] Definitions of Print/Mockup file categories that can be attached to this product
id string Deprecated file type identifier. Please use type field instead!
type string File type identifier - use this to specify a file's purpose when creating an order
title string Display name
additional_price string Additional price when this print file type is used
options OptionType [ ] Definitions of additional options that are available for this product
id string Option identifier - use this to specify the option when creating an order
title string Display name
type string Data type of this option (currently only 'bool' is supported)
values array Option values - [key, value] map
additional_price string Additional price when this option is used
additional_price_breakdown array Additional price breakdown by type - [key, value] map
is_discontinued boolean If product is disabled in push
description string Product description
variants Variant [ ] Array of Variants available for the selected product
id integer Variant ID, use this to specify the product when creating orders
product_id integer ID of the product that this variant belongs to
name string Display name
size string Item size
color string Item color
color_code string Hexadecimal RGB color code. May not exactly reflect the real-world color
color_code2 string Secondary hexadecimal RGB color code. May not exactly reflect the real-world color
image string URL of a preview image for this variant
price string Variant's price (can change depending on print files and optional settings)
in_stock boolean Stock availability of this variant
availability_regions array Map of [region code, region name] of regions where the variant is available for fulfilment
Clave API
id Product ID
Ejecutar

¿Listo para probar Printful?