L'API publique de creativehub permet à votre propre logiciel de téléverser des œuvres, de créer et publier des drops, et de passer des commandes. Les requêtes vont à https://escher-v2.creativehub.io/v1 avec un jeton bearer esch_live_ : consultez Comment créer des jetons d'API pour la surface publique /v1 pour en obtenir un.
Documentation
La documentation de l'API est publique sur https://sell.creativehub.io/api-docs (https://api.creativehub.io y mène aussi). La surface /v1 complète est également décrite sur l'endpoint OpenAPI (/openapi.json sur le service d'API).
Les groupes d'endpoints
- Uploads :
POST /v1/uploads(un fichier),POST /v1/uploads/ref(une image par URL), sessions de téléversement (POST /v1/uploads/sessions,…/sessions/complete),POST /v1/uploads/link(un lien temporaire où quelqu'un dépose des fichiers dans un navigateur),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(logo, signature, lettre). - 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(une œuvre). - Page styles :
GET /v1/styles/schema,GET /v1/styles,POST /v1/styles/extract(renvoie cinq variantes au choix),GET /v1/styles/variations/{id},POST /v1/styles,GET/PATCH/DELETE /v1/styles/{style_id},POST /v1/drops/{drop_id}/style-preview(un lien d'aperçu valable 15 minutes). - 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}.
Téléverser des fichiers
Vous pouvez téléverser des fichiers directement. POST /v1/uploads prend les octets du fichier comme corps de la requête : le corps est le fichier brut, pas un formulaire multipart. Il accepte les JPEG, PNG ou TIFF jusqu'à 2 Go et exige un en-tête Content-Length ; un formulaire multipart est refusé avec un HTTP 415.
Si l'image est déjà hébergée, enregistrez-la plutôt par son URL publique avec POST /v1/uploads/ref. Les sessions de téléversement (/v1/uploads/sessions) et les liens de téléversement (/v1/uploads/link) sont les deux autres voies.
Vérifiez vous-même vos images
Il n'existe pas d'endpoint de contrôle préalable pour la résolution, les dimensions, les proportions ou le profil colorimétrique. Validez chaque image dans votre propre back-end avant de commander, et préparez-la à la zone d'image exacte que vous voulez imprimer.
Pour savoir à quoi ressemble un fichier prêt à imprimer, comment photographier ou scanner votre œuvre propose quatre vérifications qui montrent si un fichier est assez bon.
Bordures sur les variantes
Les bordures définies via l'API ne sont que des préréglages : none, small ou large. Vous ne pouvez pas définir une bordure par côté.
Avant d'automatiser une sortie, il est utile d'en voir une du côté de l'acheteur : la page Print Drops montre à quoi ressemble une vente à durée limitée et comment elle se déroule.