极兔速递对接流程

1. 概述

1.1 应用场景

使用极兔速递承接物流履约、运单流转或轨迹跟踪的客户，可以通过观远数据连接器同步极兔速递相关数据，用于物流状态分析、发货跟踪、异常件监控和履约看板建设。

1.2 功能简介

观远数据连接器通过极兔速递开放平台接口获取数据。客户需要先在极兔速递开放平台获取连接器所需授权字段，再在观远侧创建“极兔速递”数据账户。

1.3 注意事项

正式对接前，请确认使用的是客户自己的极兔速递开放平台账号，并已创建或开通可用于接口对接的应用。privateKey 属于敏感信息，不要在文档、聊天记录或截图中明文传播。

观远数据连接器对接“极兔速递”时，需要填写以下两个字段：

本文档的重点是说明客户应到极兔速递开放平台的哪里获取这两个字段。

2. 观远数据连接器侧准备

登录观远数据连接器平台：

https://apiconnector.guandata.com/

进入控制台后，点击左侧菜单“数据账户管理”，再点击“新增数据账户”。

3. 获取授权信息

3.1 字段获取入口

极兔速递开放平台入口：

https://open.jtexpress.com.cn/

字段定位参考页：

https://www.jijyun.cn/help/detail/527

说明：极兔速递开放平台是官方入口。字段定位参考页为第三方帮助页，页面中展示了 apiAccount 和 privateKey 的获取位置；实际字段值以客户登录极兔速递开放平台后看到的信息为准。

3.2 登录极兔速递开放平台

打开极兔速递开放平台，点击右上角“登录”或“控制台”。如果尚未登录，请使用客户自己的极兔开放平台账号登录。

3.3 进入个人中心并添加应用

登录后进入“控制台”，在左侧点击“个人中心”，再点击页面下方的“添加应用”。

如果客户已经创建过用于接口对接的应用，可以直接进入已有应用；如果没有应用，需要先按极兔开放平台要求添加应用并完成必要审核或开通。

3.4 复制 apiAccount 和 privateKey

在“应用管理”中展开对应应用，页面会显示 apiAccount 和 privateKey。将这两个字段复制出来，后续填写到观远数据连接器的数据账户表单中。

填写前请确认：

• apiAccount 和 privateKey 来自同一个应用。
• 使用的是正式对接所需的应用，不要混用测试应用。
• 复制时不要带入多余空格或换行。
• privateKey 是敏感信息，不要在文档、聊天记录或截图中明文传播。

4. 连接“极兔速递”数据账户

在观远数据连接器“新增数据账户”页面中，所属平台选择：

极兔速递

选择后，页面会展示需要填写的字段：账户名称、apiAccount、privateKey。

填写说明：

填写完成后，点击“测试连接”。测试通过后，点击“确定”保存数据账户。

5. 后续数据使用

数据账户保存成功后，即可在后续数据同步或取数流程中选择该“极兔速递”数据账户。

如果测试连接失败，优先检查 apiAccount、privateKey 是否复制完整，以及极兔开放平台应用是否已开通对应接口权限。

6. 完整流程

1. 登录极兔速递开放平台。
2. 进入“控制台 > 个人中心 > 应用管理”。
3. 添加或展开应用，复制 apiAccount 和 privateKey。
4. 登录观远数据连接器，进入“数据账户管理 > 新增数据账户”。
5. 所属平台选择“极兔速递”，填写账户名称、apiAccount、privateKey。
6. 点击“测试连接”，通过后保存。