FedEx Tracking API

WhereParcel 통합 추적 API로 FedEx 택배를 추적하세요. Ground, Express 등 모든 FedEx 서비스 지원.

빠른 시작

FedEx 택배를 하나의 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.fedex",
      "trackingNumber": "789456123012"
    }]
  }'

FedEx 송장번호 형식

서비스	형식	예시
FedEx Express / Ground	`XXXX XXXX XXXX (12 digits)`	`789456123012`
FedEx Ground (96/98)	`XXXX XXXX XXXX XXXX XXXX (20 digits)`	`61299998620341578901`

코드 예시

JavaScript / Node.js

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.fedex',
      trackingNumber: '789456123012',
    }],
  }),
});

const data = await response.json();
console.log(data.trackingItems[0].status);
// → "in_transit", "delivered", etc.

Python

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.fedex',
            'trackingNumber': '789456123012',
        }],
    },
)

data = response.json()
print(data['trackingItems'][0]['status'])

웹훅으로 실시간 업데이트

폴링 대신 웹훅을 등록하여 FedEx 상태 업데이트를 자동으로 수신하세요. 송장번호당 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({
    url: 'https://yourapp.com/webhooks/tracking',
    description: 'FedEx tracking updates',
  }),
});