班牛数据账户接入指南

1. 接入前准备

观远连接器的“班牛”数据账户需要同一班牛开放平台应用的 AppKey、AppSecret 和 AccessToken。请使用有权管理该应用的班牛账号操作。

2. 获取班牛连接信息

2.1 打开 Open API 应用

登录班牛工作台，从左侧“更多”进入“连接”，打开“Open API”。如尚未申请 Open API，先在该页面提交申请；应用状态显示“正常”后，打开“查看详情”。下图保留了 Open API 页的导航和应用卡片，可用于辨认“查看详情”的位置。

公开资料脱敏示例，仅用于辅助识别页面位置；实际页面以班牛工作台为准。

2.2 查找 AppKey 与 AppSecret

在 Open API 应用的详情页，查看“基础信息”中的 Appkey 和 App Secret。App Secret 如被隐藏，使用页面上的“查看”操作。下图还保留了应用详情卡片；继续进入对应应用的管理页，可查看 AccessToken。

公开资料脱敏示例，仅用于辅助识别字段名称；请在班牛工作台的 Open API 应用详情中获取自己应用的实际值。

2.3 查找 AccessToken

从应用详情中的应用卡片进入“应用管理”，打开“应用信息”。在 AccessToken 一行读取访问令牌。下图显示了应用管理左侧导航与 AccessToken 字段的相对位置。

公开资料脱敏示例，仅用于辅助识别字段名称；请在班牛工作台的应用管理页中读取当前应用的令牌。

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

进入数据账户管理，点击“新增数据账户”，所属平台选择“班牛”。账户名称可按业务用途自定义；其余三项填写同一个班牛应用的连接信息。

填完后点击“测试连接”。测试通过后点击“确定”保存。若测试失败，核对三项信息是否来自同一应用，并在该应用的“接口权限”中确认目标接口已获准使用；连接测试会调用 common.getSeller。

4. 找不到 Open API 或应用信息

请让班牛管理员检查当前账号的应用管理权限及 Open API 开通状态，再按第 2 节的路径查看。不要把其他应用的 Appkey、App Secret 与 AccessToken 混填。