用户手册
帮助中心/用户手册/接 Ordoro:验证您的 API 凭证

接 Ordoro:验证您的 API 凭证

最后更新 2026-11-01

在 Ordoro 的 Settings → Account Settings → API Keys 里创建 API Key,把它的 Client ID 与 Client Secret 填进 Integration,再测试——测试用 HTTP Basic 只读列一下您的 shipper,确认凭证能用。

这个 Ordoro 连接用来验证您的 Ordoro API 凭证在 Integration 里能不能用:它用 HTTP Basic 校验一个 Ordoro API Key 的 Client ID 与 Client Secret,并读取您的 shipper 列表。请先清楚它的范围——本连接只做凭证连通验证,不做比价、不买面单、也不按单号查轨迹,因为 Ordoro 的费率与面单是按其订单走的端点。测试通过只证明凭证可用,不证明其他功能。

Ordoro 接入步骤:先创建 API Key,再填它的两个值,再测试,最后激活。

前置条件#

  • 一个能登录的 Ordoro 账号,且能进 Settings → Account Settings → API Keys。
  • 有在该页面创建 API Key 的权限。一个 Key 会同时给您需要的两个值:Client ID 与 Client Secret。
  • 不要打算在这里填 Ordoro 登录邮箱和密码。用邮箱密码登录 API 的方式已被 Ordoro 弃用,填进这两个字段不会成功——见常见问题第一条。

拿凭证#

  1. 登录 Ordoro,去 Settings → Account Settings → API Keys。
  2. 在该页面创建一个 API Key。
  3. 复制刚创建的这个 Key 的 Client ID。这个 Client ID 就是 HTTP Basic 认证的用户名。
  4. 复制同一个 API Key 的 Client Secret,并妥善保存。这个 Client Secret 就是 HTTP Basic 认证的密码,且必须与上面的 Client ID 来自同一个 Key。

填进 Integration#

  1. 打开 Integration → 连接器市场 → Ordoro → 新建连接。
  2. API Key Client ID(client_id):粘贴您的 Ordoro API Key 的 Client ID——就是从 Settings → Account Settings → API Keys 复制的那个。它按密钥保存,永不回显。不要在这里填 Ordoro 登录邮箱。
  3. API Key Client Secret(client_secret):粘贴同一个 API Key 的 Client Secret。它按密钥保存,永不回显。不要在这里填 Ordoro 登录密码,也不要把另一个 Key 的 Secret 配到上面的 Client ID 上。
  4. 就这两个字段——本连接只有这两个字段。没有账号、店铺域名或环境字段要填。

测试连接#

点测试连接。测试先检查两个字段是否都已填,再用 HTTP Basic——Client ID 作用户名、Client Secret 作密码——只读列一下您的 shipper(GET /shipper/?limit=1)。能返回 shipper 列表,测试就通过。请把这个结果读窄一点:测试通过只证明这对 API Key 凭证能登录并读到该列表,不证明费率、面单、订单或轨迹能走这个连接。测试失败时先记下报错,对照下方常见问题排查。

配 Mapping / 选模板#

本连接没有 Mapping 要配,也没有模板要选。它不拉订单进来,也不往回推任何东西,所以没有订单字段可映射。比价、买面单、按单号查轨迹同样不属于本连接:在 Ordoro 里,费率与面单走的是从 Ordoro 订单出发的按单端点,轨迹信息也在订单本身上。请把本连接用在它唯一做的事上——验证您的 Ordoro API Key 凭证能用——费率与面单请走 Ordoro 里按订单的流程处理。

测试实际做的事:用 HTTP Basic 发一次只读的 shipper 请求,仅此而已。

激活#

测试通过后激活连接,把这对已验证的凭证保存在 Integration 里,之后可以用同样的值再测试。激活不会启动任何数据流:本连接不拉订单、不报费率、不买面单、也不同步轨迹。如果以后在 Ordoro 里新建了 API Key,请把这里的两个字段都换成新 Key 的值,并重新测试后再使用这个连接。

常见问题#

我填了 Ordoro 登录邮箱和密码,但测试失败

这两个字段根本不收登录凭证。用邮箱和密码登录 Ordoro API 的方式已被 Ordoro 弃用,所以把登录邮箱填进 Client ID 字段、登录密码填进 Client Secret 字段,每次都会被拒绝。

去 Ordoro → Settings → Account Settings → API Keys,创建一个 API Key,把它的 Client ID 填进 client_id 字段、把同一个 Key 的 Client Secret 填进 client_secret 字段,再重新测试。

测试报 401

Ordoro 没有接受这对 Client ID 与 Client Secret。常见原因是打字或复制出错、两个值填反了字段、复制时带了多余空格,或 Client ID 配了另一个 API Key 的 Client Secret。

在 Ordoro → Settings → Account Settings → API Keys 里打开您要用的那一个 API Key,从同一个 Key 重新复制两个值、不带多余空格,确认 Client ID 在 client_id、Client Secret 在 client_secret,再重新测试。

测试通过了,但在这里不能比价、买面单或查轨迹

这是本连接的实际范围,不是您的设置出了问题。在 Ordoro 里,费率与面单走按订单的端点,所以本连接没有可调用的独立比价或买单入口;轨迹信息也在 Ordoro 订单上,而不是靠单号查询。本连接只用只读 shipper 列表验证凭证。

请把测试通过只当作凭证可用的证明,不要期待更多。费率与面单请走 Ordoro 里按订单的流程、从 Ordoro 订单出发处理;轨迹请在 Ordoro 里看该订单上的发货信息。

测试提示凭证缺失

两个字段里有一个或两个是空的。测试会先检查字段,缺凭证就如实提示缺失、不会报成功,所以没填完的连接不会看起来像已接通。

把两个字段都填上——client_id 填一个 Ordoro API Key 的 Client ID,client_secret 填同一个 Key 的 Client Secret——保存后重新测试。