唯品会接口是唯品会开放平台为合作伙伴提供的编程接口,基于 RESTful 架构,使用 HTTP 协议进行数据交换,具有多种功能且有相应的对接流程及注意事项,以下是详细介绍:
-
接口功能类型
- 商品数据接口:可获取商品详情、价格、库存、分类等信息。
- 订单接口:能查询订单状态、交易金额、退货率等。
- 用户接口:用于访问用户行为数据,如浏览历史、购买偏好等。
- 营销接口:主要用于管理特卖活动、优惠券发放等。
-
部分接口示例
- 查询自动抢货订单列表:该接口用于查询预购订单信息,需要补货的订单是授权最新状态为 0 - 授权成功的部分。接口查询时间是最后更新时间,查询时间段最大不超过 2 小时。
- 库存同步:供应商可通过此接口同步库存,同步库存时,不需要扣减自动抢货订单的数量。
- 下载时效订单:自动抢货订单抢货成功后,会下发时效订单,商家需要在查询到时效订单之后及时进行库存占用。
-
对接流程
- 注册与认证:访问唯品会开放平台官网(vop.vip.com),注册企业或个人账号并完成实名认证,然后完善供应商信息并提交认证。
- 申请 API 权限:在后台选择所需接口,提交申请说明用途,审核通常需 1-3 个工作日。
- 获取 API 密钥:审核通过后,系统生成 App Key 和 App Secret,用于身份验证。
- 进行接口调用:使用 HTTP 请求,按照唯品会规定的参数格式和签名规则进行调用,响应通常为 JSON 格式。
-
签名规则
- 参数筛选:收集所有请求参数,不含 sign 本身。
- ASCII 升序排序:按参数名首字母 ASCII 码升序排列。
- 字符串拼接:按 “key=value&key=value” 格式拼接。
- 追加密钥:在拼接字符串末尾直接加 appSecret。
- SHA256 加密:将最终字符串用 UTF-8 编码后做 SHA256 加密,结果即为 sign 值,且为小写。