よくある質問
WhereParcelの荷物追跡APIについてよくある質問をまとめました。お探しの回答が見つからない場合は、コミュニティ掲示板でご質問ください。
一般
WhereParcelとは何ですか？
WhereParcelは、世界500社以上の配送会社を1つのREST APIで統合追跡できる荷物追跡APIです。各配送会社と個別に連携する必要がなく、1つのAPIで正規化されたJSONレスポンスを取得できます。
WhereParcelは何社の配送会社に対応していますか？
WhereParcelは16カ国500社以上の配送会社に対応しています。CJ Logistics、韓進エクスプレス、ロッテグローバルロジスティクス、USPS、UPS、FedEx、DHL、ヤマト運輸、佐川急便、ロイヤルメールなどの主要キャリアを含みます。
どの国に対応していますか？
アメリカ、韓国、日本、ドイツ、イギリス、カナダ、オーストラリア、中国、インド、シンガポール、ニュージーランド、アイルランド、南アフリカ、香港、フィリピンのキャリアと、越境配送の国際キャリアに対応しています。
ECサイト（ネットショップ）に適していますか？
もちろんです。WhereParcelはEC、物流、配送プラットフォーム向けに設計されています。一括追跡（リクエストあたり最大500件）、注文ステータスページ用のリアルタイムWebhook、マルチキャリア対応など、オンラインショップに必要な全機能を提供します。
はじめに
どうやって始めればいいですか？
whereparcel.com/signupで無料アカウントを作成してください。ダッシュボードからAPIキーを取得し、5分以内に最初の追跡リクエストを送信できます。クレジットカードは不要です。
連携方法は？
APIキーを取得後、キャリアコードと追跡番号で/v2/trackにPOSTリクエストを送信するだけです。cURL、Node.js、Python、PHP、Goのコード例を提供しています。whereparcel.com/docsでクイックスタートガイドをご確認ください。
キャリアコードの形式は？
キャリアコードは{国}.{キャリア}の形式です。例：us.usps、kr.cjlogistics、jp.yamato、de.dhl。GET /v2/carriersで全キャリアコード一覧を確認できます。
登録前にAPIをテストできますか？
はい！whereparcel.com/playgroundでサンプルデータを使って追跡リクエストをテストできます。アカウント不要ですぐに体験できます。
API・技術
APIの応答時間はどのくらいですか？
キャッシュされた結果は500ms以内、ライブ配送会社検索は2〜3秒以内に応答します。米国、ヨーロッパ、アジアの5つのリージョンにデプロイされており、場所に関係なく低レイテンシーを提供します。
1回のリクエストで複数の荷物を追跡できますか？
はい。1回のPOST /v2/trackリクエストに最大500件の荷物を含めることができ、それぞれ異なるキャリアでも可能です。すべての結果が1つのレスポンスで返されます。
どのような認証方式を使用していますか？
すべてのAPIリクエストにAuthorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEYヘッダーが必要です。登録後にダッシュボードからキーを取得でき、TLS暗号化接続で送信されます。
キャリアの自動検出に対応していますか？
現在は各追跡リクエストでキャリアコードの指定が必要です。追跡番号の形式による自動検出機能は、将来のアップデートで提供予定です。
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が登録したURLにPOSTリクエストを送信し、更新された追跡データを配信します。ポーリング不要で即座に通知を受け取れます。
繰り返しWebhookと一回限りのWebhookの違いは？
recurring: trueに設定すると、配達完了まですべてのステータス変更時に通知を送信します。recurring: falseに設定すると、1回だけ検索して結果を配信します。
Webhook配信が失敗した場合、再試行されますか？
はい。エンドポイントが一時的に利用できない場合、WhereParcelは指数バックオフ方式で自動的に再試行し、重要なステータス更新を逃さないようにします。
料金・お支払い
無料プランはありますか？
はい。WhereParcelは月1,000件の追跡リクエストが無料です。クレジットカード不要で今すぐ始められ、500社以上のすべてのキャリアを利用できます。利用量に応じてアップグレードできます。
有料プランにはどのようなものがありますか？
Starter（$49/月）は10,000件とWebhookを含みます。Pro（$99/月）は30,000件と優先サポートを含みます。Business（$199/月）は300,000件、専任サポート、99.95% SLAを含みます。
レート制限はありますか？
はい、レート制限はプランによって異なります。無料プランは1日100件、月1,000件です。有料プランはより高い制限が設定されています。詳細は料金ページをご確認ください。
隠れた費用はありますか？
ありません。WhereParcelは透明なリクエスト単位の料金設定です。選択したプランの料金のみお支払いいただきます。初期費用、隠れた手数料、長期契約はありません。