接 ShippingEasy：验证您的 API 凭证

最后更新 2026-11-01

在 ShippingEasy 同一个 API Credentials 页面复制 API Key 和 API Secret，填进 Integration，跑一次签名测试——这个连接只做凭证验证。

ShippingEasy 连接器在 Integration 里验证您的 ShippingEasy API 凭证。您需要填入 API Key 和 API Secret；每个请求都用 Secret 做 HMAC-SHA256 签名，Secret 本身不会明文发送。这个连接只做凭证连通验证——在 ShippingEasy Customer API 口径下，它不提供比价、买面单，也不提供按单号查轨迹。

ShippingEasy 接入步骤：在同一页成对拿凭证，填进去，再跑签名测试。

前置条件#

一个 ShippingEasy 账号，且能进 Settings → API Credentials。
备好 API Key 和 API Secret——两者在同一页：Settings → API Credentials（app.shippingeasy.com/settings/api_credentials）。
开始前先清楚这个连接的用途：它只验证凭证，不会给 Integration 增加比价、买面单或查轨迹功能。

拿凭证#

登录 ShippingEasy，进 Settings → API Credentials（app.shippingeasy.com/settings/api_credentials）。
在该页复制 API Key。它是这个账号的 public API key。
在同一页复制 API Secret。它是 private API secret：每个请求都用它做 HMAC-SHA256 签名，Secret 本身不会明文发出。
把 Key 和 Secret 当作同一页取出的一对一起保存，并把 Secret 妥善保管。

填进 Integration#

打开 Integration → 连接器市场 → ShippingEasy → 新建连接。
API Key（api_key）——必填：粘贴 ShippingEasy → Settings → API Credentials 里的 API Key。Key 只填进 Key 字段——不要和 Secret 填反。
API Secret（api_secret）——必填：粘贴同一个 Settings → API Credentials 页面上的 API Secret。加密存储，永不回显；Integration 用它给每个请求做 HMAC-SHA256 签名，Secret 本身不会明文发送。

测试连接#

点测试连接。测试会用您的 API Secret 对一个只读请求签名，调用 GET https://app.shippingeasy.com/api/orders?per_page=1，只列 1 条订单探活。通过说明这对签名凭证能用、能列出订单。它不证明其他任何事：它不查费率、不买面单、也不查轨迹，因为这个连接不提供这些功能。

配 Mapping / 选模板#

这个连接没有 Mapping，也没有模板可选。它不把订单拉进其他系统，也不配发货服务映射：在 ShippingEasy Customer API 口径下，通过这个连接做比价、买面单、按单号查轨迹都不支持，所以这些功能没有可配的 Mapping。需要费率或面单时，请直接在 ShippingEasy 里操作。

ShippingEasy 验证流程：一次带签名的只读探活，只列一条订单。

激活#

激活后，连接会以已验证状态保存，可用于凭证检查。不会有其他功能通过它跑起来：比价、买面单、查轨迹都不属于这个连接，请继续在 ShippingEasy 里做这些事。如果您在 ShippingEasy 里换了 API Key 或 API Secret，在这里把两个值都更新并重新测试。

常见问题#

测试报 401

API Key 或 API Secret 错了，或两者填反了，导致 HMAC-SHA256 签名对不上，ShippingEasy 拒绝了这次签名探活。

回 ShippingEasy → Settings → API Credentials（app.shippingeasy.com/settings/api_credentials），把 API Key 原样复制到 API Key 字段、API Secret 原样复制到 API Secret 字段——两者取自同一页——再重新测试。

测试提示凭证缺失

有一个或两个字段是空的。测试没有 API Key 和 API Secret 两者就无法给请求签名，所以在探活之前就停下了。

从同一个 Settings → API Credentials 页面把两个字段都填上，保存后重新测试。只填其中一个不够。

测试通过了，但不能比价、买面单或查轨迹

这是这个连接的范围，不是故障：它只验证凭证。测试通过只证明这对签名凭证能列出订单——ShippingEasy Customer API 没有给这个连接提供费率端点、买面单端点或按单号查轨迹的端点。

这个连接只用于凭证检查，费率、面单和其他发货操作请继续在 ShippingEasy 里做。不要指望测试通过就能在 Integration 里启用这些功能。