택배 API 연동이 복잡하고 어렵다고 생각하시나요? DeliveryAPI를 사용하면 회원가입부터 첫 API 호출까지 단 5분이면 완료됩니다.

💡 이 가이드를 따라하면
• 15개 택배사를 하나의 API로 통합
• 실시간 배송 조회 구현
• 배송 등록 자동화
• 웹훅으로 실시간 알림 수신

1단계: 회원가입 (1분)

DeliveryAPI는 이메일 인증으로 간편하게 가입할 수 있습니다.

  1. 회원가입 페이지로 이동
  2. 이메일 주소 입력
  3. 이메일로 받은 6자리 인증 코드 입력
  4. 자동으로 API Key와 Secret Key 발급

신용카드 등록 불필요! 무료 플랜(월 30,000회)으로 바로 시작할 수 있습니다.

2단계: API 키 확인

이메일 인증이 완료되면 자동으로 API 키가 발급됩니다.

API Key: pk_live_1234567890abcdef
Secret Key: sk_client_minimal_abcdef1234567890
⚠️ 보안 주의사항
• API 키는 절대 클라이언트 코드에 노출하지 마세요
• 서버 환경변수에 저장하세요
• 키가 노출되면 즉시 재발급하세요

3단계: 첫 API 호출 (2분)

배송 조회 예제 (JavaScript)

const axios = require('axios');

const API_KEY = 'sk_live_1234567890abcdef';
const TRACKING_NUMBER = '1234567890';
const CARRIER = 'cj'; // CJ대한통운

async function trackDelivery() {
  try {
    const response = await axios.get(
      `https://api.deliveryapi.co.kr/v1/tracking/${CARRIER}/${TRACKING_NUMBER}`,
      {
        headers: {
          'Authorization': `Bearer ${API_KEY}`,
          'Content-Type': 'application/json'
        }
      }
    );
    
    console.log('배송 상태:', response.data);
    return response.data;
  } catch (error) {
    console.error('조회 실패:', error.response.data);
  }
}

trackDelivery();

응답 예시

{
  "status": "success",
  "data": {
    "carrier": "cj",
    "trackingNumber": "1234567890",
    "status": "in_transit",
    "statusText": "배송중",
    "estimatedDelivery": "2024-12-12T14:00:00Z",
    "currentLocation": "서울특별시 강남구",
    "events": [
      {
        "timestamp": "2024-12-11T09:00:00Z",
        "status": "picked_up",
        "location": "서울 강남구 집화"
      },
      {
        "timestamp": "2024-12-11T13:00:00Z",
        "status": "in_transit",
        "location": "경기 용인 간선상차"
      }
    ]
  }
}

4단계: 배송 등록 (2분)

배송 등록 예제

async function createDelivery() {
  const deliveryData = {
    carrier: 'cj',
    sender: {
      name: '홍길동',
      phone: '010-1234-5678',
      address: '서울특별시 강남구 테헤란로 123',
      zipCode: '06234'
    },
    receiver: {
      name: '김철수',
      phone: '010-9876-5432',
      address: '경기도 성남시 분당구 판교역로 235',
      zipCode: '13494'
    },
    item: {
      name: '노트북',
      quantity: 1,
      weight: 2.5,
      price: 1500000
    }
  };

  try {
    const response = await axios.post(
      'https://api.deliveryapi.co.kr/v1/deliveries',
      deliveryData,
      {
        headers: {
          'Authorization': `Bearer ${API_KEY}`,
          'Content-Type': 'application/json'
        }
      }
    );
    
    console.log('송장번호:', response.data.trackingNumber);
    return response.data;
  } catch (error) {
    console.error('등록 실패:', error.response.data);
  }
}

지원되는 택배사

다음 단계

기본 연동을 완료했다면 다음 기능들을 살펴보세요:

지금 바로 시작하세요!

무료 플랜으로 월 30,000회 API 호출 제공

무료로 시작하기 →