Lister les boutiques avec l'API Printify
Liste 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.
- Identifiant
- printify_list_shops
L'appel
POST https://connect.reportei.com/api/tools/printify_list_shops/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Cette tool ne prend aucun argument.
Connexions possibles
Votre client connecte son compte Printify une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
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.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/printify_list_shops. Il devient la définition de tool de votre agent sans conversion.
Autres tools Printify
- 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.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
