唯品会数据连接器对接指南
唯品会数据连接器对接指南
1. 适用范围
本文说明如何准备唯品会开放平台（VOP）应用凭据，在观远连接器创建唯品会数据账户并完成授权。唯品会供应商、MP 商家和服务商的入驻路径不同，应先根据业务身份选择唯品会官方接入场景。
2. 准备唯品会开放平台资质
2.1 注册开发者并创建应用
使用负责对接的唯品会账号登录唯品会开放平台控制台。根据业务身份创建相应应用；例如供应商自研系统按官方供应商自研系统流程创建应用，MP 商家自研系统按官方 MP 商家自研系统流程办理。应用创建和审核后，在“控制台 → 我的应用／管理应用”进入应用详情，并按需申请接口权限。
 唯品会官方教程示例：在控制台“管理应用”中进入应用详情。示例页面可能与当前后台略有差异。查看官方服务商应用接入说明。
2.2 获取 App Key 和 App Secret
在开放平台的应用列表或应用详情中查看 App Key。下图是唯品会官方授权说明提供的已脱敏示例，红框标出 AppKey。App Secret 是同一应用的鉴别密钥，应使用应用详情展示的密钥；公开示例不会展示真实密钥。若当前账号看不到密钥，请由该应用的管理员登录查看或联系唯品会开放平台支持。
 官方已脱敏示例：应用列表中的 AppKey 位置。进入对应应用详情核对密钥，勿将 App Secret 放入截图。查看官方授权说明；查看应用标识与密钥的官方定义。
唯品会开发者协议说明应用标识与应用密钥由平台分配。应用接口使用 appKey 标识应用，使用 appSecret 参与鉴别；请妥善保存密钥，不要使用其他应用的密钥。
2.3 准备连接器字段
| 字段 | 来源 | 在连接器中的用途 |
|---|
App Key（appKey） | 唯品会开放平台对应应用的列表或详情；查看官方 AppKey 位置示例 | 识别应用。 |
App Secret（appSecret） | 与 App Key 属于同一应用的密钥；查看官方密钥定义 | 应用鉴别和授权。 |
客户标识（customerId） | 填写本次授权所对应的唯品会账号名称，用于在连接器中区分授权账户。 | 区分不同账户或店铺；它不是 App Key、App Secret，也无需在官方应用页另找一个同名字段。 |
3. 创建观远连接器数据账户
3.1 填写表单
在“数据账户管理”中点击“新增数据账户”，将“所属平台”设为“唯品会”。填写便于内部识别的账户名称、同一应用的 App Key 与 App Secret，并将本次授权的唯品会账号名称填入“客户标识”。
 观远连接器表单：App Key、App Secret、客户标识均为必填字段。
3.2 字段映射
| 来源 | 连接器字段 | 必填 | 获取入口 |
|---|
| 唯品会应用 App Key | 应用 Key appKey | 是 | 官方 AppKey 位置示例 |
| 同一应用的 App Secret | 应用密钥 appSecret | 是 | 开放平台应用管理；官方密钥说明 |
| 本次授权的唯品会账号名称 | 客户标识 customerId | 是 | 连接器内的账户区分字段；使用本次授权账号名称。 |
3.3 完成 OAuth 授权并保存
点击“立即授权”，在唯品会页面使用本次需要授权的账号登录，核对授权范围后完成授权。返回连接器，确认状态由“未完成”变为已授权，再点击“确定”保存。供应商场景应使用已关联的 VOP 授权账号；MP 商家场景应按官方 MP 接入说明使用店铺主账号。唯品会的官方授权流程说明了登录和授权页面。
 唯品会官方授权页示例：确认应用和授权范围后完成授权。查看官方授权流程。
4. 常见问题
| 问题 | 处理建议 |
|---|
| 找不到 App Secret | 核对是否进入创建 App Key 的同一个应用详情，并确认当前登录账号有管理该应用的权限。不要把 App Key 当作密钥。查看官方说明。 |
| 授权仍显示“未完成” | 确认使用了与当前业务场景相符的唯品会授权账号，并完成唯品会授权页操作；检查应用权限和账号绑定状态。查看官方接入场景。 |
| 
