whereparcel

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

업계 소식 6 분 소요

USPS 추적 API 2026년 변화: 개발자가 알아야 할 것

2026년 USPS가 추적 API를 대폭 변경했습니다. 무엇이 바뀌었고, 왜 중요하며, 어떻게 대응해야 하는지 정리했습니다.

WhereParcel Team

USPS 추적 기능을 앱에 통합하고 있다면, 2026년에 무언가 크게 바뀌었음을 눈치챘을 것입니다. USPS가 추적 인프라를 대폭 변경했으며, 이는 개발자가 소포 데이터에 접근하는 방식을 근본적으로 바꾸었습니다. 이 변화를 이해하고 올바른 대응책을 준비하는 것이 중요합니다.

무엇이 바뀌었는가

1. Web Tools API 폐지 (2026년 1월 25일)

USPS가 레거시 Web Tools API 플랫폼을 공식 폐지했습니다. 이 API를 여전히 사용하고 있다면, 더 이상 작동하지 않습니다. 새로운 USPS API로의 마이그레이션은 필수입니다.

2. 요청 제한: 시간당 60회

새로운 USPS API는 매우 제한적인 요청 한도를 제시합니다: 시간당 60회 요청. 이것이 얼마나 심각한지 이해하기 위해 이전과 비교해보겠습니다.

지표이전현재변화
분당 평균 요청 수~6,00016,000배 감소
일일 소포 1,000개 추적✅ 가능❌ 불가능심각
일일 소포 100개 추적✅ ~100회✅ 100회문제 없음
일일 소포 1,000개 추적✅ ~1,000회❌ 일일 한도 초과불가능

의미: 하루에 수십 개 이상의 소포를 USPS로 추적하려면, 시간당 60회 제한이 심각한 병목이 됩니다.

3. 제3자 추적 제한 (2026년 4월 1일)

물류 플랫폼에게 가장 큰 타격인 변화입니다: 자신이 발송하지 않은 소포의 추적 데이터를 조회할 수 없게 되었습니다.

이전에는 추적번호만 있으면 어떤 USPS 소포든 상태를 확인할 수 있었습니다. 이제 USPS는 Mailer ID 관계를 요구합니다. 즉, 당신이 발송인임을 증명해야 합니다. 이것이 의미하는 바:

  • 이커머스 플랫폼 — 고객이 다른 사람의 주문을 추적할 수 없음
  • 3PL 물류업체 — 고객의 소포를 별도 설정 없이 추적 불가능
  • 소포 픽업 서비스 — 픽업 전 소포 상태 확인 불가능

이 제한은 고객 대면 추적 페이지, 물류 대시보드, 또는 소포 통합 서비스를 구축하는 모든 업체에 영향을 미칩니다.

실제 영향

중소 고객사 500개를 대상으로 하는 물류 SaaS 플랫폼을 생각해봅시다. 각 고객사가 일일 10개씩 USPS로 발송한다면:

일일 총 USPS 추적 요청 = 500개 고객사 × 10개 소포 = 5,000회/일
새로운 USPS API 한도 = 시간당 60회 = 1,440회/일

결과: 전체 소포의 약 14%만 추적 가능

이런 플랫폼에서는 USPS API가 실질적으로 사용 불가능한 상태가 됩니다.

개발자들의 대응 방식

이러한 제한 앞에서 개발자들은 세 가지 주요 선택지를 가지고 있습니다.

선택지 1: USPS에 높은 한도 신청

USPS는 확대된 API 접근을 신청할 수 있도록 허용합니다. 하지만:

  • 승인 기준이 공개되지 않음
  • 승인 소요 시간이 명시되지 않음
  • 승인이 보장되지 않음
  • 제3자 추적 제한은 그대로 유지됨

이 선택지는 기껏해야 부분적 완화만 제공합니다.

선택지 2: 맞춤형 추적 인프라 구축

일부 팀은 USPS 데이터를 독자적으로 수집·캐싱하는 시스템을 구축하고 있습니다. 이 접근법:

  • ✅ 요청 한도 문제 해결
  • ✅ 제3자 추적 문제 해결
  • ❌ 상당한 개발 투자 필요
  • ❌ 택배사 시스템 변경에 따른 지속적 유지보수 필요
  • ❌ 규모의 경제 없음 (한 회사가 한 솔루션)

선택지 3: 통합 다중 택배사 API 활용

WhereParcel 같은 제3자 추적 통합 서비스는 USPS API 제한에 영향을 받지 않습니다. USPS 인프라에 의존하는 대신:

  • 독자적인 추적 데이터 인프라 운영
  • 수백 개 택배사의 통합 API 제공
  • USPS와 다른 미국 택배사 모두 포함
  • 무제한, 고용량 추적 지원

통합 추적 API가 해결하는 방법

WhereParcel을 사용하면 USPS를 다른 택배사와 동일하게 추적합니다:

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": "us.usps", "trackingNumber": "9400111899223456789012" }
    ]
  }'

응답:

{
  "success": true,
  "data": [
    {
      "carrier": "us.usps",
      "trackingNumber": "9400111899223456789012",
      "status": "success",
      "data": {
        "deliveryStatus": "out_for_delivery",
        "estimatedDelivery": "2026-04-17",
        "events": [
          {
            "timestamp": "2026-04-16T08:30:00Z",
            "status": "in_transit",
            "location": "Boston Distribution Center",
            "description": "배송 중"
          }
        ],
        "lastUpdated": "2026-04-16T08:30:00Z"
      },
      "billable": true,
      "cached": false
    }
  ],
  "summary": {
    "total": 1,
    "success": 1,
    "failed": 0,
    "usageIncremented": 1
  }
}

주요 이점:

  • ✅ Mailer ID 불필요
  • ✅ 시간당 요청 제한 없음
  • ✅ 모든 추적번호 지원
  • ✅ 39개 이상 택배사에 동일한 표준화된 API (USPS만 아님)
  • ✅ 폴링 대신 웹훅 알림

대량 추적 시나리오에서 이 접근법이 다른 대안보다 훨씬 안정적이고 비용 효율적입니다.

지금 해야 할 일

현재 USPS Web Tools API를 사용 중이라면:

  1. 아직 하지 않았다면 즉시 새로운 USPS API로 마이그레이션
  2. 시간당 60회 제한이 실제 사용량과 맞는지 검토
  3. 한도를 초과하거나 제3자 추적이 필요하면, 통합 추적 API 검토

새로운 추적 통합을 구축 중이라면:

  1. USPS API 단독 의존 피하기
  2. 처음부터 다중 택배사 플랫폼 고려
  3. 향후 고용량 확장을 대비한 설계

물류 플랫폼을 운영 중이라면:

  1. USPS 추적 용량 감시
  2. 스테이징에서 새로운 한도 테스트
  3. 프로덕션에서 한도 초과 전에 대응책 준비

다음 단계

USPS API 변화는 현실이지만, 극복 불가능한 것은 아닙니다. WhereParcel 시작하기 — 언제든 취소 가능 — 하고 요청 한도와 Mailer ID 제한 걱정 없이 USPS 소포를 추적하세요.

원하는 택배사가 없으신가요? 요청해 주시면 빠르게 연동해 드립니다.

택배사 요청하기 →

궁금한 게 있으세요? 편하게 물어보세요. Discord에 들어오시면 WhereParcel을 만든 개발자가 직접 읽고 답장드립니다. 봇도 없고 티켓도 없어요. 그냥 편하게 대화하세요.

Discord 참여하기 → Slack 참여하기 →

태그: #usps #api-changes #tracking-api #2026