よくある質問
WhereParcelの荷物追跡APIについてよくある質問をまとめました。お探しの回答が見つからない場合は、コミュニティ掲示板でご質問ください。
一般
WhereParcelとは何ですか?
WhereParcelは、39社以上の運用中配送会社(ご要望のキャリアは迅速追加)を1つのREST APIで統合追跡できる荷物追跡APIです。各配送会社と個別に連携する必要がなく、1つのAPIで正規化されたJSONレスポンスを取得できます。
WhereParcelは何社の配送会社に対応していますか?
WhereParcelは現在9か国 + 国際の39社以上の配送会社が運用中です。ヤマト運輸、日本郵便、DHL、FedEx、UPS、OnTracなどの主要キャリアを含みます。ご要望のキャリアがない場合はコミュニティ掲示板でリクエスト — 迅速に追加します。
どの国に対応していますか?
アメリカ、韓国、日本、ドイツ、イギリス、カナダ、イタリア、スペイン、トルコのキャリアと、越境配送の国際キャリアに対応しています。
ECサイト(ネットショップ)に適していますか?
もちろんです。WhereParcelはEC、物流、配送プラットフォーム向けに設計されています。一括追跡(リクエストあたり最大5件)、注文ステータスページ用のWebhook、マルチキャリア対応など、オンラインショップに必要な全機能を提供します。
はじめに
どうやって始めればいいですか?
連携方法は?
APIキーを取得後、キャリアコードと追跡番号で/v2/trackにPOSTリクエストを送信するだけです。cURL、Node.js、Python、PHP、Goのコード例を提供しています。クイックスタートガイドをご確認ください。
キャリアコードの形式は?
キャリアコードは{国}.{キャリア}の形式です。例:us.usps、kr.cj、jp.yamato、intl.dhl。GET /v2/carriersで全キャリアコード一覧を確認できます。
登録前にAPIをテストできますか?
はい!APIプレイグラウンドでサンプルデータを使って追跡リクエストをテストできます。アカウント不要ですぐに体験できます。
API・技術
APIの応答時間はどのくらいですか?
キャッシュされた結果は500ms以内、ライブ配送会社検索は2〜3秒以内に応答します。APIは米国東部(us-east1)リージョンから提供しています。
1回のリクエストで複数の荷物を追跡できますか?
はい。1回のPOST /v2/trackリクエストに最大5件の荷物を含めることができ、それぞれ異なるキャリアでも可能です。すべての結果が1つのレスポンスで返されます。
どのような認証方式を使用していますか?
すべてのAPIリクエストにAuthorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEYヘッダーが必要です。登録後にダッシュボードからキーを取得でき、TLS暗号化接続で送信されます。
キャリアの自動検出に対応していますか?
はい。POST /v2/detect が追跡番号の形式だけから候補のキャリアを返します(無料・利用量にカウントされません)。specificityScore が最も高い候補のコードで追跡してください。
OpenAPI仕様は提供されていますか?
はい。英語(whereparcel.com/openapi.en.yaml)、韓国語(whereparcel.com/openapi.ko.yaml)、日本語(whereparcel.com/openapi.ja.yaml)の3言語でOpenAPI 3.0仕様を提供しています。
Webhook・通知
Webhookはどのように機能しますか?
WebhookエンドポイントURLを登録し、追跡する荷物を登録してください。WhereParcelは荷物を約12時間ごとに再確認し、確認のたびに登録したURLへPOSTリクエストを送信して最新の追跡データを配信します(ステータスが変わったかどうかはhasChangesで分かります)。ポーリングは不要です。Webhookベストプラクティスガイド
繰り返しWebhookと一回限りのWebhookの違いは?
recurring: trueに設定すると、配達完了まで(最大10日間)約12時間ごとに再確認し、確認のたびに通知を送信します。recurring: falseに設定すると、1回だけ検索して結果を配信します。
Webhook配信が失敗した場合、再試行されますか?
いいえ。Webhookは1回だけ送信します。エンドポイントが応答しない場合やエラーを返した場合、その配信は再送されません。見逃した変更は GET /v2/webhooks/subscriptions/{requestId}/changes でいつでも取得でき、次のステータス変更は通常どおり配信されます。
料金・お支払い
無料で試すことはできますか?
無料トライアルはありません。プランをご購入いただくとすぐに39社以上のすべての運用中キャリアをご利用いただけます。いつでも解約でき、解約後も請求期間の終了までご利用いただけます。ご契約中のお客様がWhereParcelを紹介する記事を書いてくださると、アンバサダープログラムで3ヶ月の無料利用を差し上げます。料金プランを見る
有料プランにはどのようなものがありますか?
Starter($49/月)は10,000件とWebhookを含みます。Pro($99/月)は30,000件と優先サポートを含みます。Business($650/月)は300,000件、専任サポート、99.95% SLAを含みます。どのプランもいつでも解約できます。プラン比較
レート制限はありますか?
はい、レート制限はプランによって異なります。1分あたり30件(Starter)〜200件(Business)の範囲です。レート制限ガイドで詳細をご確認ください。
まだご不明な点がありますか?
コミュニティ掲示板でご質問ください。チームや他の開発者が回答いたします。