Aller au contenu
API

Créer un parcours de personnalisation avec l’API Order

Si vos clients créent leur propre coque dans votre application, l’API Order vous permet d’envoyer le visuel final directement en production et de suivre la commande jusqu’à la livraison grâce aux webhooks.

Ce que vous obtenez

L’accès API est inclus dans l’offre Pro. Vous créez une clé dans le compte, et l’URL de base est https://app.tullunprint.com/api/v1. Pas d’inscription développeur séparée.

Le parcours

  • Lisez le catalogue avec GET /catalog pour lister les types de coques et les appareils pris en charge
  • Hébergez le visuel du client à une adresse https publique ; la commande l’indique comme fichier de l’article
  • Créez la commande avec POST /orders : le type de coque, l’appareil, le lien du visuel et l’adresse de livraison
  • Enregistrez un webhook avec POST /webhooks et recevez les changements de statut au fil de la production et de l’expédition
  • Interrogez GET /orders/{id} à tout moment pour le statut actuel et le suivi

Exigences pour le visuel

Envoyez des fichiers prêts à imprimer : 300 dpi, sRGB, avec fond perdu. L’API vérifie les dimensions par rapport à la zone d’impression de la coque choisie ; une interface de personnalisation doit donc exporter à la taille du modèle d’impression de cet appareil.

Les statuts qui comptent pour votre client

« Received », « Being made » et « On its way », avec le numéro de suivi dès qu’il existe. Reportez-les sur votre propre page de commande pour que le client voie toujours les mêmes mots dans le même ordre.

Où trouver les détails

Paramètres des endpoints, exemples de données et clés se trouvent sur la page API de votre compte vendeur. La page API publique de ce site présente le modèle en un coup d’œil.

Toutes les ressources

Prêt à lancer votre activité POD ?

Connectez votre boutique, créez vos produits et laissez-nous la production et le fulfillment.