Listar blueprints en Printify, con una API
Lista todo el catálogo de productos en blanco de Printify, llamados blueprints, con id, title, brand, model e imágenes, en una única respuesta larga. Prefiere el blueprint_id de un producto existente cuando uno sirva.
- Identificador
- printify_list_blueprints
La llamada
POST https://connect.reportei.com/api/tools/printify_list_blueprints/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Esta tool no recibe argumentos.
Conexiones posibles
Tu cliente conecta su cuenta de Printify una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/printify_list_blueprints. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de Printify
- Listar tiendasGETLista las tiendas de la cuenta con id, title y sales_channel, como shopify, etsy o disconnected. El id es el shop_id que piden todas las otras herramientas.
- Listar productosGETLista los productos de una tienda con title, description, tags, variantes con precio en centavos, imágenes de mockup, blueprint_id, print_provider_id y estado de publicación. 10 por página por defecto; current_page y last_page vienen en la respuesta.
- Obtener productoGETDevuelve un producto: title, description, tags, opciones, variantes con sku, precio y coste en centavos, áreas de impresión con las imágenes y su posición, mockups, is_locked y los enlaces al canal de ventas.
- Crear productoPOSTCrea un producto en una tienda a partir de un blueprint del catálogo, un print provider, las variantes a vender con sus precios y las imágenes subidas colocadas en cada área de impresión. Una imagen de baja resolución se rechaza con el error 8203. El producto no se publica: usa Publicar producto.
- Actualizar productoPUTModifica un producto y lo devuelve. Solo cambian los campos enviados, pero variants debe listar todas las variantes del producto. Se rechaza mientras is_locked sea true, durante una publicación. Los cambios llegan al canal de ventas solo después de Publicar producto.
- Publicar productoPOSTEnvía un producto al canal de ventas de la tienda, como Shopify o Etsy, y lo bloquea en Printify hasta que el canal confirme; en una tienda conectada por API, esa tienda tiene que confirmar. Cada campo true se envía, false conserva lo que tiene el canal. Limitado a 200 llamadas cada 30 minutos.
- Listar pedidosGETLista los pedidos de una tienda con estado, líneas, dirección, costes en centavos y envíos con seguimiento. Como máximo 10 por página; current_page y last_page vienen en la respuesta.
- Obtener pedidoGETDevuelve un pedido: estado, líneas con su estado de producción, dirección de envío, costes en centavos, envíos con transportista y seguimiento, y las fechas de creación, producción y cumplimiento.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
