whereparcel

궁금한 게 있으세요? 편하게 물어보세요. WhereParcel을 만든 개발자가 직접 읽고 답장드립니다.

← United States

USPS Tracking API

WhereParcel 통합 추적 API로 USPS 택배를 추적하세요. Priority Mail, First-Class 등 모든 USPS 서비스 지원.

플레이그라운드 열기 문서 보기 요금제 보기

USPS

택배사 코드
us.usps
국가
🇺🇸 United States

USPS 송장번호 형식

서비스형식예시
Priority Mail9400 1118 9922 3XXX XXXX XX9400111899223456789017
First-Class Package9205 5XXX XXXX XXXX XXXX XX9205590164917312345677
Priority Mail InternationalECXX XXXX XXXX USEC123456785US

빠른 시작

USPS 택배를 하나의 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'))

웹훅으로 자동 업데이트

폴링 대신 웹훅을 등록하면 USPS 택배를 약 12시간마다 다시 조회해 상태를 보내 드립니다. 송장번호당 1건만 사용량이 차감됩니다.

// 웹훅 엔드포인트 등록
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 택배 추적을 몇 분 안에 시작하세요.

문서 보기 플레이그라운드 열기