La API pública de creativehub permite que tu propio software suba obras, cree y publique drops y haga pedidos. Las solicitudes van a https://escher-v2.creativehub.io/v1 con un token de tipo bearer esch_live_; consulta Cómo crear tokens de API para la superficie pública /v1 para obtener uno.
Documentación
La documentación de la API es pública en https://sell.creativehub.io/api-docs (https://api.creativehub.io también te lleva allí). Toda la superficie /v1 también se describe en el endpoint de OpenAPI (/openapi.json en el servicio de la API).
Los grupos de endpoints
- Uploads:
POST /v1/uploads(un archivo),POST /v1/uploads/ref(una imagen por URL), sesiones de subida (POST /v1/uploads/sessions,…/sessions/complete),POST /v1/uploads/link(un enlace temporal donde alguien arrastra archivos en un navegador),GET /v1/uploads,GET /v1/uploads/{id}. - Drops:
POST /v1/drops,GET /v1/drops,GET/PATCH/DELETE /v1/drops/{drop_id},POST /v1/drops/{drop_id}/assets(logotipo, firma, carta). - Products:
POST /v1/drops/{drop_id}/products,PUT /v1/drops/{drop_id}/products/{product_id}/variants,DELETE …/products/{product_id};GET /v1/products,GET /v1/products/{id},GET /v1/products/{id}/variants. - Recommendations:
POST /v1/recommendations(un drop),POST /v1/drops/{drop_id}/products/{product_id}/recommendations(una obra). - Page styles:
GET /v1/styles/schema,GET /v1/styles,POST /v1/styles/extract(devuelve cinco variaciones para elegir),GET /v1/styles/variations/{id},POST /v1/styles,GET/PATCH/DELETE /v1/styles/{style_id},POST /v1/drops/{drop_id}/style-preview(un enlace de vista previa de 15 minutos). - Publishing:
POST /v1/drops/{drop_id}/publish,GET /v1/drops/{drop_id}/publish-attempts/latest. - Orders and invoices:
POST /v1/orders/quote,POST /v1/orders,GET /v1/orders,GET /v1/orders/{id},GET /v1/invoices,GET /v1/invoices/{id}.
Subir archivos
Puedes subir archivos directamente. POST /v1/uploads recibe los bytes del archivo como cuerpo de la solicitud: el cuerpo es el archivo en bruto, no un formulario multipart. Acepta JPEG, PNG o TIFF de hasta 2 GB y necesita una cabecera Content-Length; un formulario multipart se rechaza con HTTP 415.
Si la imagen ya está alojada, regístrala por su URL pública con POST /v1/uploads/ref. Las sesiones de subida (/v1/uploads/sessions) y los enlaces de subida (/v1/uploads/link) son las otras dos vías.
Comprueba tú mismo tus imágenes
No hay un endpoint de preflight para dpi, dimensiones, proporción ni perfil de color. Valida cada imagen en tu propio backend antes de hacer el pedido y prepárala con el área de imagen exacta que quieres imprimir.
Para saber cómo es un archivo listo para imprimir, cómo fotografiar o escanear tu obra tiene cuatro comprobaciones que indican si un archivo es lo bastante bueno.
Bordes en las variantes
Los bordes que se definen mediante la API son solo valores predefinidos: none, small o large. No se puede fijar un borde por lado.
Antes de automatizar un lanzamiento, conviene ver uno desde el lado del comprador: la página de Print Drops muestra cómo se ve y cómo funciona una venta con tiempo limitado.