Qué puede hacer la API pública /v1

api pública

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.

¿Aún necesitas ayuda?

Pregunta al asistente de ayuda integrado desde tu panel de creativehub, o envíanos un correo — una persona real responderá. info@creativehub.io