唯品会API接口

71 阅读2分钟

唯品会接口是唯品会开放平台为合作伙伴提供的编程接口,基于 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 值,且为小写。