WhereParcel APIを始めよう
WhereParcelのグローバル荷物追跡APIを10分以内にアプリケーションに統合する方法を学びましょう。
WhereParcel Team
WhereParcelは、世界中の39社以上の配送業者の荷物を追跡できる統合APIを提供しています。ECサイト、物流ダッシュボード、顧客通知システムなど、どのようなサービスを構築する場合でも、当社のAPIを使えばリアルタイムの追跡データを簡単に取得できます。
前提条件
始める前に、以下をご用意ください:
- WhereParcelアカウント(こちらからサインアップ)
- ダッシュボードで取得したAPIキー
- REST APIの基本的な知識
ステップ1:APIキーを取得する
サインアップ後、ダッシュボードに移動して新しいAPIキーを作成してください。キーは以下のような形式になります:
wp_live_a1b2c3d4e5f6g7h8i9j0
このキーは安全に保管し、クライアントサイドのコードには絶対に公開しないでください。
ステップ2:最初のリクエストを送信する
APIを使って荷物を追跡する方法は以下のとおりです:
curl -X POST https://api.whereparcel.com/v2/track \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY" \
-d '{
"trackingItems": [{ "carrier": "kr.cj", "trackingNumber": "1234567890" }]
}'
ステップ3:レスポンスを解析する
APIは配送業者に関係なく、標準化された追跡レスポンスを返します:
{
"success": true,
"data": [
{
"carrier": "kr.cj",
"trackingNumber": "1234567890",
"status": "success",
"data": {
"deliveryStatus": "in_transit",
"estimatedDelivery": "2026-02-05",
"events": [
{
"timestamp": "2026-02-01T10:30:00Z",
"status": "in_transit",
"location": "Seoul Sorting Center",
"description": "Package picked up from sender"
}
],
"lastUpdated": "2026-02-01T10:30:00Z"
},
"billable": true,
"cached": false
}
],
"summary": {
"total": 1,
"success": 1,
"failed": 0,
"usageIncremented": 1
}
}
次のステップ
最初のリクエストが完了したら、以下のトピックもご覧ください:
- 認証ガイド - APIキーのセキュリティに関するベストプラクティスを学ぶ
- Webhookの設定 - 配達通知を自動で受け取る
- 配送業者一覧 - 39社以上の対応配送業者を確認する
快適な荷物追跡をお楽しみください!
ご希望の配送業者が見つかりませんか?リクエストいただければ迅速に対応いたします。
配送業者をリクエスト →もっと見る
何か聞きたいことがあれば、気軽にどうぞ。 Discordに来てください — WhereParcelを作った開発者が直接メッセージを読んで返信します。ボットもチケットもなし。気軽に話しかけてください。
Discordに参加 → Slackに参加 →