京准通对接指南

1. 适用范围

本文适用于需要通过观远连接器接入京准通广告及经营分析数据的客户。完成对接前，请确认您具备京东开发者中心应用的管理权限，以及待授权店铺/账号的授权权限。

本平台使用 OAuth 授权方式。客户在观远连接器中填写应用信息后，需按京东页面提示完成账号授权；观远不会要求您提供京东账号密码、短信验证码或已获取的访问令牌。

2. 申请平台对接资质

2.1 登录京东开发者中心并准备应用

1. 使用拥有应用管理权限的京东账号登录京东开发者中心。
2. 在控制中心创建或选择用于数据对接的自有应用，并按京东页面提示申请所需接口权限。
3. 在应用详情中保存 AppKey 与 AppSecret。AppSecret 仅应由负责配置数据账户的人员保管，请勿通过聊天、邮件或截图外传。

不同账号的菜单名称和可申请权限可能不同，请以京东开发者中心当前页面为准。

2.2 配置授权回调地址

如果京东开发者中心在应用配置中要求填写授权回调地址、Redirect URI 或回调 URL，请原样填写以下固定地址：

https://apiconnector.guandata.com/auth-callback/JINGZHUNTONG

• 必须使用 https，且地址末尾不要添加斜杠、查询参数或任何其他字符。
• 不要填写客户自有域名、京东开发者中心首页或本文档地址。
• 若修改了应用的回调地址、AppKey 或授权范围，请重新完成一次京东授权，并在连接器中重新测试连接。

2.3 完成店铺/账号授权

京东官方授权工具说明：自研商家登录后输入 AppKey 并授权，即可将当前账号对应店铺的数据授权给该应用。实际操作时，请使用拥有待接入店铺权限的账号完成授权。

前往京东官方授权工具，使用 AppKey 完成商家授权

2.4 核对应用字段

京东官方签名工具展示了 OAuth 调用所使用的 app_key、app_secret 与 access_token 等字段。连接器会在授权后的调用过程中处理访问令牌与签名；客户只需在数据账户中维护本指南列出的字段。

查看京东官方签名工具与字段说明

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

3.1 新增数据账户

1. 进入观远连接器的数据账户管理，点击新增数据账户。
2. 选择平台京准通。
3. 按下表填写字段。一个店铺/账号建议对应一个数据账户；如需配置多个账户，每个数据账户的 customerId 必须不同。

连接器数据账户表单截图待补充：请在连接器后台选择“京准通”后，截取完整表单区域并发送给观远支持人员。截图中请先遮盖真实密钥、店铺名称、账号或其他业务信息。

3.2 字段映射关系

3.3 授权、测试连接并保存

1. 确认字段无误后，按连接器页面提示发起授权。
2. 在跳转的京东页面使用拥有待接入数据权限的账号登录并确认授权；完成后返回连接器。
3. 点击测试连接。测试通过后保存数据账户，再选择所需接口创建同步任务。

若京东页面提示应用没有权限，请先在京东开发者中心为该应用申请相应接口权限，并重新完成授权。

4. 常见问题

官方资料：京东开发者中心授权工具、京东开发者中心签名工具。本文截图采集自上述京东官方公开页面。