Obtenir une commande avec l'API Printify
Renvoie 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.
- Identifiant
- printify_get_order
L'appel
POST https://connect.reportei.com/api/tools/printify_get_order/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>",
"order_id": "<order_id>"
}
}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
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| shop_id | string | Oui | Id of the shop, from List shops. |
| order_id | string | Oui | Id of the order, from List orders. |
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_get_order. Il devient la définition de tool de votre agent sans conversion.
Autres 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.
- 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.
