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 接続手順：同じページで 2 つの認証情報を取得し、入力して、署名テストを実行。

前提条件#

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 をコピーします。これはこのアカウントの公開 API キーです。
同じページで API Secret をコピーします。これは非公開の API シークレットです。各リクエストはこれを使って HMAC-SHA256 で署名され、シークレット自体が平文で送信されることはありません。
Key と Secret はその 1 ページで取得したペアとして一緒に保管し、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 では、この接続を通じた料金比較、ラベル購入、追跡番号による追跡検索はサポートされていないため、それらについてマッピングするものはありません。料金やラベルが必要な場合は、ShippingEasy 自体でその作業を行ってください。

ShippingEasy の確認フロー：署名付きの読み取り専用プローブで注文を 1 件一覧表示。

有効化#

有効化後、接続は確認済みとして保存され、認証情報のチェックに利用できます。それ以外の機能がこの接続経由で動き出すことはありません。料金比較、ラベル購入、追跡検索はこの接続には含まれないため、それらは引き続き ShippingEasy 自体で行ってください。ShippingEasy で API Key または API Secret を置き換えた場合は、ここでも両方の値を更新し、再テストしてください。

よくある質問#

テストが 401 で失敗する

API Key または API Secret が間違っているか、2 つが入れ替わっているため、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 でそれらの機能が有効になるとは期待しないでください。