产品 API

使用产品 API 搜索已同步的产品、批量检查保修资格，并为产品注册保修保障。

搜索产品

GET /api/public/products/search

按标题、SKU、条形码或供应商搜索您已同步的产品目录。

查询参数：

• search（必填）— 搜索关键词，至少 2 个字符
• limit（选填）— 最大结果数，默认 20，最多 50
• myshopifyDomain（选填）— 按店铺域名筛选
• orgId（选填）— 提供后，结果会包含资格数据（isEligible、warrantyIds、匹配的规则）

检查产品资格（批量）

GET /api/public/products/eligibility

一次检查多个产品的保修资格。

查询参数：

• productIdsString（必填）— 以逗号分隔的产品 ID
• orgId（必填）— 组织 ID

返回每个产品的 isEligible、defaultExtendedWarrantyId、defaultOEMWarrantyId 和 warrantyIds。

注册产品

POST /api/public/products/register

通过面向顾客的注册表单为产品注册保修保障。

必填字段： productId、purchaseDate、purchasedFrom、customerName、customerEmail、shopDomain

选填字段： customerPhone、orderNumber、serialNumber、warrantyId、warrantyType、warrantyTerm、purchaseProofFileCount、productPhotoFileCount

验证规则：

• 购买日期必须是今天或更早，且在过去 2 年以内
• 电子邮件格式必须有效
• 产品必须存在于该 Shopify 店铺中
• 店铺域名必须已在 Umbrella 注册

成功时返回 registrationId 和 registrationNumber，状态为 pending。系统会向顾客发送确认邮件，商家有 30 天时间进行审核。

相关内容

• 身份验证 — API 凭据
• 保修 API — 保修计划管理
• 注册与序列号 API — 注册查询与序列号验证
• 端点概览 — 完整端点列表