Ordoro 接続：API 認証情報を確認する

Ordoro の Settings → Account Settings → API Keys で API キーを作成し、その Client ID と Client Secret を Integration に入力してテストします。テストは HTTP Basic で shipper を読み取り専用で一覧し、認証情報が使えるか確認します。

この Ordoro 接続は、Ordoro API 認証情報が Integration で使えるかを確認するためのものです。Ordoro API キーの Client ID と Client Secret を HTTP Basic で確認し、shipper 一覧を読み取ります。範囲を明確にしてください。この接続は認証情報の確認専用です。料金比較、ラベル購入、追跡番号での追跡検索は行いません。Ordoro の料金とラベルは注文ごとのエンドポイントを通るためです。テスト合格は認証情報が使えることの証明であり、それ以上ではありません。

前提条件#

• ログインできる Ordoro アカウントがあり、Settings → Account Settings → API Keys にアクセスできること。
• そのページで API キーを作成する権限。1 つのキーで必要な 2 つの値、Client ID と Client Secret が得られます。
• ここに Ordoro のログインメールアドレスとパスワードを使うつもりでいないでください。その API ログイン方法は Ordoro により廃止されており、このフィールドでは機能しません。FAQ の最初の項目をご覧ください。

認証情報の取得#

1. Ordoro にログインし、Settings → Account Settings → API Keys へ移動します。
2. そのページで API キーを作成します。
3. 作成したキーの Client ID をコピーします。この Client ID は HTTP Basic 認証のユーザー名です。
4. 同じ API キーの Client Secret をコピーし、安全に保管します。この Client Secret は HTTP Basic 認証のパスワードであり、上の Client ID と同じキーのものでなければなりません。

Integration への入力#

1. Integration → コネクタマーケットプレイス → Ordoro → 新規接続を開きます。
2. API Key Client ID（client_id）：Ordoro API キーの Client ID を貼り付けます。Settings → Account Settings → API Keys でコピーしたものです。シークレットとして扱われ、再表示されません。ここに Ordoro のログインメールアドレスは入力しないでください。
3. API Key Client Secret（client_secret）：同じ API キーの Client Secret を貼り付けます。シークレットとして扱われ、再表示されません。ここに Ordoro のログインパスワードは入力せず、別のキーの Secret を上の Client ID と組み合わせないでください。
4. 入力は以上です。この接続のフィールドはこの 2 つだけです。口座番号、ストアドメイン、環境のフィールドはありません。

接続テスト#

接続テストをクリックします。テストはまず両フィールドが入力されているか確認し、次に HTTP Basic（Client ID をユーザー名、Client Secret をパスワード）で shipper を読み取り専用で一覧します（GET /shipper/?limit=1）。shipper 一覧が返ればテスト合格です。この結果は狭く読んでください。テスト合格は API キーの認証情報で認証でき、その一覧を読めることの証明にすぎません。料金、ラベル、注文、追跡がこの接続で機能することの証明ではありません。失敗した場合はエラーを控え、下の FAQ を確認してください。

Mapping / テンプレート選択#

この接続には設定する Mapping も、選ぶテンプレートもありません。注文を取り込まず、何も返送しないため、マッピングする注文字段がありません。料金比較、ラベル購入、追跡番号での追跡もこの接続には含まれません。Ordoro では料金とラベルは Ordoro の注文を起点とする注文ごとのエンドポイントで処理され、追跡情報は注文自体にあります。この接続は唯一の役割、Ordoro API キーの認証情報が使えるかの確認に使い、料金とラベルは Ordoro の注文ベースのフローで処理してください。

有効化#

テスト合格後、接続を有効化すると、確認済みの認証情報で Integration に保存され、後で同じ値で再テストできます。有効化でデータフローが始まることはありません。この接続では注文の取込、料金の見積、ラベルの購入、追跡の同期は行いません。後で Ordoro で新しい API キーを作成した場合は、ここで両フィールドを新しいキーの値に更新し、接続を信頼する前に再テストしてください。

よくある質問#

Ordoro のログインメールアドレスとパスワードを入力したが、テストが失敗する

この 2 つのフィールドはログイン認証情報を受け付けません。メールアドレスとパスワードによる Ordoro API の認証は Ordoro により廃止されているため、Client ID フィールドにログインメールアドレス、Client Secret フィールドにログインパスワードを入れると常に拒否されます。

Ordoro → Settings → Account Settings → API Keys で API キーを作成し、その Client ID を client_id フィールドに、同じキーの Client Secret を client_secret フィールドに入れて、再テストしてください。

テストが 401 で失敗する

Ordoro が Client ID と Client Secret のペアを受け付けませんでした。よくある原因は、入力・コピーのミス、2 つの値のフィールド間違い、値と一緒にコピーされた余分なスペース、または別の API キーの Client Secret との組み合わせです。

Ordoro → Settings → Account Settings → API Keys で使う 1 つの API キーを開き、同じキーから余分なスペースなしで両値をコピーし直し、Client ID が client_id、Client Secret が client_secret に入っていることを確認して再テストしてください。

テストは合格したが、ここで料金比較、ラベル購入、追跡ができない

これは設定の不具合ではなく、この接続の実際の範囲です。Ordoro では料金とラベルは注文ごとのエンドポイントで処理されるため、この接続が呼び出せる独立した料金取得やラベル購入はなく、追跡情報は追跡番号での検索ではなく Ordoro の注文上にあります。この接続は読み取り専用の shipper 一覧で認証情報を確認するだけです。

テスト合格は認証情報が使える証明としてのみ扱ってください。料金とラベルについては、Ordoro の注文を起点とする注文ベースのフローに従ってください。追跡については、Ordoro のその注文の発送情報を確認してください。

テストで認証情報が不足していると表示される

2 つのフィールドのどちらか一方、または両方が空です。テストはまずフィールドを確認し、成功とは報告せずに認証情報の不足を報告します。そのため、未入力の接続が接続済みに見えることはありません。

両フィールドを入力してください。client_id には Ordoro API キーの Client ID、client_secret には同じキーの Client Secret を入れ、保存して再テストしてください。