E-commerce
Printify dans votre produit et vos agents IA, via une API
Le toolkit Printify couvre les boutiques, les produits, les commandes, le catalogue de blueprints avec leurs print providers et variantes, et la médiathèque. Avec Connect, votre produit ou agent IA appelle le tout par un seul endpoint, pendant que Connect stocke le jeton d'API et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/printify_create_product/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"shop_id": "<shop_id>",
"title": "<title>",
"blueprint_id": 1,
"print_provider_id": 1,
"variants": [],
"print_areas": []
}
}Fonctionnement
Du client connecté au premier appel à Printify.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Printify. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Printify.
Créer des produits depuis des designs
Un outil de design téléverse une image depuis une URL publique et crée un produit à partir d'un blueprint, d'un print provider et des variantes à vendre.
Publier sur le canal de vente
Une app pour marchands met à jour un produit et le publie sur le canal de vente de la boutique, comme Shopify ou Etsy.
Suivre l'exécution des commandes
Un tableau de bord liste les commandes d'une boutique avec statut, coûts et expéditions avec suivi, et obtient une commande en détail.
Tools
13 tools Printify
- Lister les boutiquesGETListe les boutiques du compte avec id, title et sales_channel, comme shopify, etsy ou disconnected. L'id est le shop_id que demandent tous les autres outils.
- Lister les produitsGETListe les produits d'une boutique avec title, description, tags, variantes avec prix en centimes, images de mockup, blueprint_id, print_provider_id et statut de publication. 10 par page par défaut ; current_page et last_page figurent dans la réponse.
- Obtenir un produitGETRenvoie un produit : title, description, tags, options, variantes avec sku, prix et coût en centimes, zones d'impression avec les images et leur position, mockups, is_locked et les liens vers le canal de vente.
- Créer un produitPOSTCrée un produit dans une boutique à partir d'un blueprint du catalogue, d'un print provider, des variantes à vendre avec leurs prix et des images téléversées placées sur chaque zone d'impression. Une image en basse résolution est refusée avec l'erreur 8203. Le produit n'est pas publié : utilisez Publier un produit.
- Mettre à jour un produitPUTModifie un produit et le renvoie. Seuls les champs envoyés changent, mais variants doit lister toutes les variantes du produit. Refusé tant que is_locked vaut true, pendant une publication. Les changements n'atteignent le canal de vente qu'après Publier un produit.
- Publier un produitPOSTEnvoie un produit au canal de vente de la boutique, comme Shopify ou Etsy, et le verrouille dans Printify jusqu'à confirmation du canal ; dans une boutique connectée par API, cette boutique doit confirmer. Chaque champ à true est poussé, false conserve ce que le canal a. Limité à 200 appels toutes les 30 minutes.
- Lister les commandesGETListe les commandes d'une boutique avec statut, lignes, adresse, coûts en centimes et expéditions avec suivi. 10 par page au maximum ; current_page et last_page figurent dans la réponse.
- Obtenir une commandeGETRenvoie une commande : statut, lignes avec leur statut de production, adresse de livraison, coûts en centimes, expéditions avec transporteur et suivi, et les dates de création, de production et d'exécution.
- Lister les blueprintsGETListe tout le catalogue de produits vierges de Printify, appelés blueprints, avec id, title, brand, model et images, dans une seule longue réponse. Préférez le blueprint_id d'un produit existant quand l'un convient.
- Lister les print providers du blueprintGETListe les print providers qui fabriquent un blueprint, avec id et title. Chacun a ses propres variantes, prix et zones d'impression.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
Questions sur le toolkit Printify
Dois-je intégrer l'API Printify moi-même ?
Non. Connect fournit 13 tools Printify décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Printify ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
