← United States
USPS Tracking API
WhereParcelの統合追跡APIでUSPS荷物を追跡。Priority Mail、First-Classなど全USPSサービスに対応。
USPS
- キャリアコード
us.usps- 国
- 🇺🇸 United States
USPS 追跡番号フォーマット
| サービス | フォーマット | 例 |
|---|---|---|
| Priority Mail | 9400 1118 9922 3XXX XXXX XX | 9400111899223456789017 |
| First-Class Package | 9205 5XXX XXXX XXXX XXXX XX | 9205590164917312345677 |
| Priority Mail International | ECXX XXXX XXXX US | EC123456785US |
クイックスタート
USPSの荷物を1回のAPI呼び出しで追跡:
curl -X POST https://api.whereparcel.com/v2/track \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"trackingItems": [{
"carrier": "us.usps",
"trackingNumber": "9400111899223456789017"
}]
}' const response = await fetch('https://api.whereparcel.com/v2/track', {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}:${SECRET_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
trackingItems: [{
carrier: 'us.usps',
trackingNumber: '9400111899223456789017',
}],
}),
});
const { data } = await response.json();
console.log(data[0].data?.deliveryStatus);
// → "in_transit", "delivered", etc. import requests
response = requests.post(
'https://api.whereparcel.com/v2/track',
headers={
'Authorization': f'Bearer {API_KEY}:{SECRET_KEY}',
'Content-Type': 'application/json',
},
json={
'trackingItems': [{
'carrier': 'us.usps',
'trackingNumber': '9400111899223456789017',
}],
},
)
item = response.json()['data'][0]
print(item.get('data', {}).get('deliveryStatus')) Webhookで自動更新
ポーリングの代わりにWebhookを登録すれば、USPSの荷物を約12時間ごとに再確認してステータスをお送りします。追跡番号1件あたり1リクエストのみカウントされます。
// Webhookエンドポイントを登録
await fetch('https://api.whereparcel.com/v2/webhook-endpoints', {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}:${SECRET_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
name: 'Production',
url: 'https://yourapp.com/webhooks/tracking',
description: 'USPS tracking updates',
}),
});USPSの荷物追跡を数分で開始。
ドキュメントを見る プレイグラウンドを開く