Met de openbare creativehub-API kan je eigen software kunstwerken uploaden, drops bouwen en publiceren en bestellingen plaatsen. Verzoeken gaan naar https://escher-v2.creativehub.io/v1 met een esch_live_-bearer-token. Zie API-tokens aanmaken voor het openbare /v1-oppervlak om er een te krijgen.
Documentatie
De API-documentatie is openbaar op https://sell.creativehub.io/api-docs (https://api.creativehub.io brengt je er ook naartoe). Het volledige /v1-oppervlak wordt ook beschreven bij het OpenAPI-endpoint (/openapi.json op de API-service).
De endpointgroepen
- Uploads —
POST /v1/uploads(een bestand),POST /v1/uploads/ref(een afbeelding via URL), uploadsessies (POST /v1/uploads/sessions,…/sessions/complete),POST /v1/uploads/link(een tijdelijke link waar iemand in een browser bestanden kan neerzetten),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, handtekening, brief). - Producten —
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. - Aanbevelingen —
POST /v1/recommendations(een drop),POST /v1/drops/{drop_id}/products/{product_id}/recommendations(één kunstwerk). - Paginastijlen —
GET /v1/styles/schema,GET /v1/styles,POST /v1/styles/extract(geeft vijf variaties om uit te kiezen),GET /v1/styles/variations/{id},POST /v1/styles,GET/PATCH/DELETE /v1/styles/{style_id},POST /v1/drops/{drop_id}/style-preview(een previewlink van 15 minuten). - Publiceren —
POST /v1/drops/{drop_id}/publish,GET /v1/drops/{drop_id}/publish-attempts/latest. - Bestellingen en facturen —
POST /v1/orders/quote,POST /v1/orders,GET /v1/orders,GET /v1/orders/{id},GET /v1/invoices,GET /v1/invoices/{id}.
Bestanden uploaden
Je kunt bestanden rechtstreeks uploaden. POST /v1/uploads neemt de bytes van het bestand als request body: de body is het ruwe bestand, geen multipart-formulier. Het accepteert JPEG, PNG of TIFF tot 2 GB en vereist een Content-Length-header; een multipart-formulier wordt geweigerd met HTTP 415.
Is de afbeelding al ergens gehost, registreer haar dan in plaats daarvan met haar openbare URL via POST /v1/uploads/ref. Uploadsessies (/v1/uploads/sessions) en uploadlinks (/v1/uploads/link) zijn de andere twee routes.
Controleer je afbeeldingen zelf
Er is geen preflight-endpoint voor dpi, afmetingen, beeldverhouding of kleurprofiel. Valideer elke afbeelding in je eigen backend voordat je bestelt, en bereid haar voor op precies het beeldvlak dat je gedrukt wilt hebben.
Hoe een printklaar bestand eruitziet, lees je in zo fotografeer of scan je je kunstwerk, met vier controles die laten zien of een bestand goed genoeg is.
Randen bij varianten
Randen die via de API worden ingesteld, zijn alleen presets: none, small of large. Je kunt geen rand per zijde instellen.
Voordat je een release automatiseert, helpt het om er een te bekijken door de ogen van de koper: de pagina Print Drops laat zien hoe een verkoop met tijdslimiet eruitziet en verloopt.