WhereParcel APIを始めよう

WhereParcelは、世界中の500社以上の配送業者の荷物を追跡できる統合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.cjlogistics", "trackingNumber": "1234567890" }]
  }'

ステップ3：レスポンスを解析する

APIは配送業者に関係なく、標準化された追跡レスポンスを返します：

{
  "success": true,
  "data": {
    "carrier": "kr.cjlogistics",
    "trackingNumber": "1234567890",
    "status": "in_transit",
    "estimatedDelivery": "2026-02-05",
    "events": [
      {
        "timestamp": "2026-02-01T10:30:00Z",
        "status": "picked_up",
        "location": "Seoul Sorting Center",
        "description": "Package picked up from sender"
      }
    ]
  }
}

次のステップ

最初のリクエストが完了したら、以下のトピックもご覧ください：

• 認証ガイド - APIキーのセキュリティに関するベストプラクティスを学ぶ
• Webhookの設定 - リアルタイムの配達通知を受け取る
• 配送業者一覧 - 500社以上の対応配送業者を確認する

快適な荷物追跡をお楽しみください！