whereparcel

何か聞きたいことがあれば、気軽にどうぞ。WhereParcelを作った開発者が直接メッセージを読んで返信します。

よくある質問

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キーを取得し、5分以内に最初の追跡リクエストを送信できます。プランはいつでも解約でき、解約後も請求期間の終了までご利用いただけます。
連携方法は?
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ヶ月の無料利用を差し上げます。料金プランを見る
レート制限はありますか?
はい、レート制限はプランによって異なります。1分あたり30件(Starter)〜200件(Business)の範囲です。レート制限ガイドで詳細をご確認ください。
隠れた費用はありますか?
ありません。WhereParcelは透明なリクエスト単位の料金設定です。選択したプランの料金のみお支払いいただきます。初期費用、隠れた手数料、長期契約はありません。

まだご不明な点がありますか?

コミュニティ掲示板でご質問ください。チームや他の開発者が回答いたします。

コミュニティを見る