API des produits

Utilisez l’API des produits pour rechercher les produits synchronisés, vérifier leur éligibilité aux garanties par lot et enregistrer des produits pour une couverture de garantie.

Rechercher des produits

GET /api/public/products/search

Recherche dans votre catalogue de produits synchronisés par titre, SKU, code-barres ou fournisseur.

Paramètres de requête :

• search (obligatoire) — terme de recherche, 2 caractères minimum
• limit (facultatif) — nombre maximal de résultats, 20 par défaut, 50 au maximum
• myshopifyDomain (facultatif) — filtre par domaine de boutique
• orgId (facultatif) — s’il est fourni, les résultats incluent les données d’éligibilité (isEligible, warrantyIds, règles correspondantes)

Vérifier l’éligibilité des produits (par lot)

GET /api/public/products/eligibility

Vérifie l’éligibilité aux garanties de plusieurs produits à la fois.

Paramètres de requête :

• productIdsString (obligatoire) — ID de produits séparés par des virgules
• orgId (obligatoire) — ID de l’organisation

Renvoie chaque produit avec isEligible, defaultExtendedWarrantyId, defaultOEMWarrantyId et warrantyIds.

Enregistrer un produit

POST /api/public/products/register

Enregistre un produit pour une couverture de garantie via le formulaire d’enregistrement destiné aux clients.

Champs obligatoires : productId, purchaseDate, purchasedFrom, customerName, customerEmail, shopDomain

Champs facultatifs : customerPhone, orderNumber, serialNumber, warrantyId, warrantyType, warrantyTerm, purchaseProofFileCount, productPhotoFileCount

Règles de validation :

• La date d’achat doit être aujourd’hui ou antérieure, et remonter à moins de 2 ans
• L’e-mail doit être dans un format valide
• Le produit doit exister dans la boutique Shopify
• Le domaine de la boutique doit être enregistré auprès d’Umbrella

En cas de succès, renvoie un registrationId et un registrationNumber avec le statut pending. Un e-mail de confirmation est envoyé au client, et le commerçant dispose de 30 jours pour examiner la demande.

Voir aussi

• Authentification — Identifiants de l’API
• API des garanties — Gestion des plans de garantie
• API d’enregistrement et de numéros de série — Recherche d’enregistrements et validation des numéros de série
• Vue d’ensemble des endpoints — Liste complète des endpoints