search_postcards
Rechercher des affiches
Recherche dans tout le catalogue d'affiches vintage par mot-clé (ville, pays, région, thème), collection et filtres de prix. Renvoie les affiches avec prix, promo, image et URL de la page produit.
Parameterssortlimitqueryoffsetregioncountrymax_pricemin_pricecollection
get_postcard
Détail d'une affiche
Fiche complète d'une affiche : description, prix, prix barré, formats, option cadre, image, frais de port et affiches similaires. Accepte un identifiant ou un nom de ville.
Parametersnameproduct_id
list_destinations
Lister les destinations
Toutes les destinations du catalogue, groupées par pays avec le nombre d'affiches et quelques exemples.
Takes no parameters.
get_catalog_overview
Vue générale du catalogue
Chiffres clés de la boutique : nombre d'affiches, pays couverts, fourchette de prix, formats, prix du cadre, règles de livraison.
Takes no parameters.
quote_cart
Calculer un panier
Devis exact d'un panier : sous-total, option cadre, frais de livraison (offerts dès 30 €) et total. À utiliser avant d'annoncer un prix au client.
Parametersitemsrequired
start_order
Ouvrir une commande
Crée une session de commande pour le client (panier + email + adresse de livraison optionnelle) et renvoie son identifiant, à utiliser ensuite avec `pay_order`. Aucun paiement n'est déclenché à cette étape.
Parametersemailrequireditemsrequiredlast_namefirst_nameshipping_address
pay_order
Payer la commande
Déclenche le paiement d'une session ouverte avec `start_order`.
• method="hosted_checkout" (défaut) : renvoie un lien de paiement Stripe à transmettre au client, qui confirme lui-même sa carte.
• method="delegated_token" : confirme immédiatement le paiement avec un token délégué. Réservé aux agents authentifiés par une clé API de la boutique, et plafonné par commande.
Parametersmethodsession_idrequiredpayment_token
get_order_status
Suivre une commande
Statut d'une commande (en attente, payée, annulée) à partir de son numéro et de l'email du client, ou de l'identifiant de session de commande.
Parametersemailorder_idsession_id
request_custom_poster
Demander une affiche personnalisée
Enregistre une demande de création d'affiche vintage sur mesure (ville, style, précisions). L'équipe recontacte le client par email avec une proposition.
Parameterscityrequiredemailrequiredstyleadditional_info
get_store_policies
Conditions de la boutique
Livraison, retours, formats, moyens de paiement et FAQ. À citer plutôt que de deviner.
Takes no parameters.