Lister les produits de la boutique avec l'API Printful
Liste les produits d'une boutique créés dans Printful pour les commandes manuelles et l'API, avec id, external_id, name et le nombre de variantes de chacun. Obtenir un produit de la boutique renvoie les variantes.
- Identifiant
- printful_list_store_products
L'appel
POST https://connect.reportei.com/api/tools/printful_list_store_products/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"status": "all"
}
}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 |
|---|---|---|---|
| status | string | Non | Only products in this group.Valeurs : all, synced, unsynced, ignored, imported, discontinued, out_of_stock |
| category_id | string | Non | Only products of these catalog categories, as comma-separated ids. The category of a catalog product is main_category_id in List catalog products. |
Connexions possibles
Votre client connecte son compte Printful 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/printful_list_store_products. Il devient la définition de tool de votre agent sans conversion.
Autres tools Printful
- Lister les commandesGETListe les commandes de la boutique avec statut, destinataire, articles, coûts et expéditions. Paginez avec offset et limit ; paging.total dans la réponse est le nombre de commandes.
- Obtenir une commandeGETRenvoie une commande avec statut, destinataire, articles, coûts et les expéditions avec transporteur et numéro de suivi.
- Créer une commandePOSTCrée une commande en brouillon et la renvoie avec les coûts calculés par Printful. Rien n'est facturé avant Confirmer la commande. recipient et items sont obligatoires, et les fichiers d'impression sont téléchargés depuis des URL publiques.
- Modifier une commandePUTModifie une commande qui n'a pas encore été soumise à la production et la renvoie. N'envoyez que les champs qui changent ; envoyer items remplace la liste d'articles. Rien n'est facturé avant Confirmer la commande.
- Confirmer une commandePOSTSoumet une commande en brouillon à la production et la renvoie. Printful débite le moyen de paiement du propriétaire de la boutique à ce moment ; une commande en attente peut encore être annulée avec Annuler la commande.
- Annuler une commandeDELETEAnnule une commande en brouillon ou en attente et la renvoie. Un montant débité retourne sur la carte du propriétaire de la boutique. Les commandes en revue, en cours ou déjà expédiées ne peuvent pas être annulées.
- Calculer les tarifs de livraisonPOSTRenvoie les modes de livraison pour une liste d'articles et une destination, avec tarif, devise et estimation de livraison. L'id d'un mode va dans shipping de Créer une commande et Modifier une commande. Appelez juste avant de commander, car les tarifs changent.
- Lister les produits du catalogueGETListe les produits vierges du catalogue Printful, comme t-shirts, mugs et posters, avec id, title, type, brand et main_category_id. Obtenir un produit du catalogue renvoie les variantes de l'un d'eux.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
