万店掌连接器对接指南

从万店掌获取应用凭据，在观远连接器中创建数据账户并完成连接测试。

1. 适用范围

适用于使用万店掌自研应用接入观远连接器的用户。开始前，请准备可用的万店掌账号、已激活的应用，并确认账号具有目标门店的数据访问权限。

2. 在万店掌获取参数

2.1 登录并进入应用管理

1. 打开万店掌开放平台登录页，使用自己的万店掌账号登录。
2. 进入控制台，在左侧选择应用 & API Key。
3. 找到本次接入使用的应用，确认卡片显示“已激活”。如果没有应用，可从页面右上角“新增应用”进入，按平台页面提示办理；需要权限或激活时联系企业管理员或万店掌支持。
4. 通过该应用的“API 列表”检查需要调用的接口；具体可用接口以应用权限为准。

2.2 找到 AppID 和两项密钥

图 1：用户提供的真实页面，账号与应用凭据已脱敏。红框分别标出登录账号、AppID 和两项密钥。实际值以自己的账户页面为准。

获取入口：打开万店掌控制台，再进入“应用 & API Key”。同一应用卡片中的 AppID、AccessKey ID、AccessKey Secret 必须配套使用。密钥显示为星号时，使用旁边的显示或复制按钮获取完整值。

2.3 确认用户名与密码

用户名是万店掌的登录账号。图中右上角显示的是当前登录身份，可用于核对；不要将应用名称、企业名称当作用户名。密码填写对应账号的登录密码，无法从应用密钥卡片中获取。如果忘记密码，通过万店掌登录页的“忘记密码”处理，或联系账号管理员。

应用凭据有三项，登录凭据有两项，共需填写五个字段。AccessKey Secret 与登录密码不能互换。不要照抄截图中的示例账号或凭据。

3. 创建观远连接器数据账户

3.1 打开新增数据账户

1. 进入观远连接器的数据账户管理，选择新增数据账户。
2. 所属平台选择万店掌。账户名称自行填写便于识别的名称，例如“万店掌门店客流”。
3. 按照下表填写五项认证信息。

3.2 字段对应关系

图 2：观远连接器数据账户表单。红框中的用户名、密码填写万店掌账号及其登录密码。账户内容已脱敏。

3.3 测试连接并保存

1. 核对三项应用凭据来自同一个应用；复制时避免首尾空格或换行。
2. 点击测试连接。若失败，根据提示检查下方常见问题。
3. 测试成功后，点击确定保存账户。
4. 使用该账户测试“门店列表”等已配置接口，确认返回的是预期门店。连接成功不代表已拥有全部业务接口权限。

4. 常见问题