Aller au contenu
Plateforme développeurs

Propulsez votre activité avec notre API.

Connectez votre plateforme directement à notre infrastructure de fabrication et de fulfillment. Les clés API sont incluses dans l’offre Pro sur app.tullunprint.com – aucune demande à faire.

Se connecter pour l’accès API Nous contacter

Comment fonctionne l’accès

Connectez-vous à votre compte vendeur et ouvrez la page API. Créez une clé pour chaque système qui communique avec nous et ajoutez l’URL à appeler lorsqu’une commande change. La référence complète – URL de base, chaque endpoint, un exemple de requête – se trouve sur cette même page.

  • Catalogue produits avec vos prix
  • Vos designs enregistrés
  • Passer des commandes
  • Statut des commandes
  • Suivi
  • Webhooks à chaque changement
  • Une clé par système
  • Fulfillment automatisé
app.tullunprint.com/merchant/api Dans votre compte
1
Se connecterLes clés API sont incluses dans l’offre Pro. Pas d’inscription développeur séparée.
2
Créer une cléUne clé par système qui communique avec nous : en révoquer une n’en bloque jamais une autre.
3
Ajouter un webhookNous appelons votre URL lorsqu’une commande change de statut, dans les mêmes termes que la page Commandes.
Ce que couvre l’API
  • GET  /catalogTout ce que nous imprimons, avec vos prix
  • GET  /designsVos designs enregistrés et leurs jetons
  • GET  /ordersVos commandes, les plus récentes d’abord
  • GET  /orders/{id}Une commande : statut, articles, suivi
  • POST /ordersPasser une commande à partir d’un design enregistré
  • POST /webhooksÊtre informé des changements de commande
  • GET  /webhooksLes URL que vous avez enregistrées
  • DELETE /webhooks/{id}En arrêter une
JSON en entrée et en sortie · les prix viennent toujours de votre catalogue, jamais de la requête · les designs sont créés dans l’éditeur et utilisés par jeton
Ce que vous pouvez créer

Tout ce que fait le tableau de bord, automatisable par script.

Lire le catalogue

Chaque coque que nous imprimons et chaque appareil compatible, au prix incluant déjà votre remise.

Utiliser vos designs

Les designs sont créés une fois dans l’éditeur et référencés par jeton – aucun visuel à envoyer dans la requête.

Passer et suivre des commandes

Envoyez une commande avec un destinataire, puis consultez son statut, ses articles et son suivi au fil de son avancement.

Soyez notifié, sans interroger l’API

Les webhooks se déclenchent à chaque changement de commande : votre système reste à jour sans rien demander.

Bon à savoir

Quelques points sur lesquels l’API est stricte.

Les clés ne s’affichent qu’une fois

Une nouvelle clé n’est affichée qu’une seule fois ; nous ne gardons qu’une empreinte. Révoquez-la et créez-en une nouvelle depuis la même page.

Les prix viennent de votre catalogue

Une requête ne fixe jamais le prix. Vous payez ce qu’indique votre catalogue au moment où la commande est passée.

Les mêmes mots partout

Les statuts de commande dans l’API, les webhooks et la page Commandes utilisent le même vocabulaire – « Being made », « On its way » – pour que rien ne soit à réinterpréter.

Un événement, tout simplement

Chaque changement de statut envoie order.updated à votre URL https avec la commande, son statut, le numéro de suivi quand il existe et l’heure.

De la marge pour travailler

Jusqu’à 120 requêtes par minute et par clé, et 30 nouvelles commandes par minute. Les clés continuent de fonctionner si vous changez d’offre ; les nouvelles clés nécessitent Pro.

Construisez sur notre infrastructure de production.

Connectez-vous à votre compte vendeur, créez une clé et commencez l’intégration dès aujourd’hui.

Se connecter pour l’accès API Découvrir les intégrations