注册与序列号 API
通过 API 管理产品注册和序列号
注册与序列号 API
使用这些端点查询产品注册，并验证序列号是否享有保修保障。
查询注册
GET /api/public/registration/lookup
查询参数：
registrationNumber（必填）— 例如UMB-REG-00089orgId（必填）— 组织 ID
返回注册记录，包括产品详情、顾客信息、状态、购买日期以及关联的保修。
注册状态
| 状态 | 说明 |
|---|---|
pending | 已提交，等待商家审核 |
approved | 已由商家批准 |
denied | 已被商家拒绝 |
expired | 30 天审核期内未处理，已过期 |
注册流程
- 顾客通过
POST /api/public/products/register提交注册（参见产品 API） - 系统验证产品和顾客数据，创建状态为
pending的注册 - 顾客收到包含注册编号的确认邮件
- 商家在仪表板中审核并批准或拒绝
- 顾客可以通过此查询端点检查状态
注意 如果商家 30 天内未处理，注册会自动过期。
验证序列号
POST /api/public/serial-numbers/validate
必填请求体字段： serialNumber、orgId
如果有效，返回 { "valid": true } 以及序列号详情（产品 ID、保修 ID、有效日期）。
如果无效，返回 { "valid": false } 及原因：已注册、已过期、已撤销、尚未生效、注册期已结束或未找到。
序列号状态
| 状态 | 说明 |
|---|---|
active | 可用于注册 |
registered | 已在注册中使用 |
expired | 有效期已结束 |
revoked | 已被商家撤销 |
批量上传序列号
序列号通过仪表板中的 CSV 上传：
- 前往 仪表板 > 序列号 > 上传
- 上传包含以下列的 CSV：
serialNumber（必填）、productId、warrantyId、validFrom、validUntil
序列号在同一组织内必须唯一。大批量数据会异步处理。
