택배조회API 개발 문서

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

result = client.tracking.trace(
    items=[
        {
            "clientId": "ORDER-2024-001",
            "courierCode": "lotte",
            "trackingNumber": "123456789012",
        }
    ]
)

print(result)

curl -X POST https://api.deliveryapi.co.kr/v1/tracking/trace \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__" \
  -d '{
    "items": [
      {
        "clientId": "ORDER-2024-001",
        "courierCode": "lotte",
        "trackingNumber": "123456789012"
      }
    ]
  }'

const response = await fetch('https://api.deliveryapi.co.kr/v1/tracking/trace', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
  },
  body: JSON.stringify({
    items: [
      {
        clientId: 'ORDER-2024-001',
        courierCode: 'lotte',
        trackingNumber: '123456789012'
      }
    ]
  })
});

const data = await response.json();
console.log(data);

import requests

url = "https://api.deliveryapi.co.kr/v1/tracking/trace"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}
data = {
    "items": [
        {
            "clientId": "ORDER-2024-001",
            "courierCode": "lotte",
            "trackingNumber": "123456789012"
        }
    ]
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

String json = """
    {
      "items": [
        {
          "clientId": "ORDER-2024-001",
          "courierCode": "lotte",
          "trackingNumber": "123456789012"
        }
      ]
    }
    """;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.deliveryapi.co.kr/v1/tracking/trace"))
    .header("Content-Type", "application/json")
    .header("Authorization", "Bearer __API_KEY__:__SECRET_KEY__")
    .POST(HttpRequest.BodyPublishers.ofString(json))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "io"
)

func main() {
    url := "https://api.deliveryapi.co.kr/v1/tracking/trace"

    data := map[string]interface{}{
        "items": []map[string]string{
            {
                "clientId":       "ORDER-2024-001",
                "courierCode":    "lotte",
                "trackingNumber": "123456789012",
            },
        },
    }

    jsonData, _ := json.Marshal(data)
    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer __API_KEY__:__SECRET_KEY__")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

result = client.tracking.get_couriers()
print(result["couriers"])

curl -X GET "https://api.deliveryapi.co.kr/v1/tracking/couriers" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/tracking/couriers',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

url = "https://api.deliveryapi.co.kr/v1/tracking/couriers"
headers = {
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}

response = requests.get(url, headers=headers)
print(response.json())

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.deliveryapi.co.kr/v1/tracking/couriers"))
    .header("Authorization", "Bearer __API_KEY__:__SECRET_KEY__")
    .GET()
    .build();

HttpResponse<String> response = client.send(request,
    HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET",
        "https://api.deliveryapi.co.kr/v1/tracking/couriers", nil)
    req.Header.Set("Authorization", "Bearer __API_KEY__:__SECRET_KEY__")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

endpoint = client.webhooks.endpoints.create(
    "https://example.com/webhooks/delivery",
    name="배송 알림 시스템",
)
# endpoint["webhookSecret"]을 안전하게 보관하세요 — 이후 조회 불가!
print(endpoint["endpointId"])

curl -X POST "https://api.deliveryapi.co.kr/v1/webhooks/endpoints" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__" \
  -d '{
    "url": "https://example.com/webhooks/delivery",
    "name": "배송 알림 시스템"
  }'

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/webhooks/endpoints',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    },
    body: JSON.stringify({
      url: 'https://example.com/webhooks/delivery',
      name: '배송 알림 시스템'
    })
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.post(
  "https://api.deliveryapi.co.kr/v1/webhooks/endpoints",
  headers={
    "Content-Type": "application/json",
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
  },
  json={
    "url": "https://example.com/webhooks/delivery",
    "name": "배송 알림 시스템"
  }
)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

result = client.webhooks.endpoints.list()
print(result["endpoints"])

curl -X GET "https://api.deliveryapi.co.kr/v1/webhooks/endpoints" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/webhooks/endpoints',
  {
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.get(
  "https://api.deliveryapi.co.kr/v1/webhooks/endpoints",
  headers={
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
  }
)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

client.webhooks.endpoints.update(
    "ep_20260101_120000_a1b2c3d4e5f6a7b8",
    name="프로덕션 엔드포인트",
)

curl -X PUT "https://api.deliveryapi.co.kr/v1/webhooks/endpoints/ep_20260101_120000_a1b2c3d4e5f6a7b8" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__" \
  -d '{"name": "프로덕션 엔드포인트"}'

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/webhooks/endpoints/ep_20260101_120000_a1b2c3d4e5f6a7b8',
  {
    method: 'PUT',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    },
    body: JSON.stringify({ name: '프로덕션 엔드포인트' })
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.put(
  "https://api.deliveryapi.co.kr/v1/webhooks/endpoints/ep_20260101_120000_a1b2c3d4e5f6a7b8",
  headers={
    "Content-Type": "application/json",
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
  },
  json={"name": "프로덕션 엔드포인트"}
)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

client.webhooks.endpoints.delete("ep_20260101_120000_a1b2c3d4e5f6a7b8")

curl -X DELETE "https://api.deliveryapi.co.kr/v1/webhooks/endpoints/ep_20260101_120000_a1b2c3d4e5f6a7b8" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/webhooks/endpoints/ep_20260101_120000_a1b2c3d4e5f6a7b8',
  {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.delete(
  "https://api.deliveryapi.co.kr/v1/webhooks/endpoints/ep_20260101_120000_a1b2c3d4e5f6a7b8",
  headers={
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
  }
)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

result = client.webhooks.endpoints.rotate_secret(
    "ep_20260101_120000_a1b2c3d4e5f6a7b8",
    webhook_secret="whsec_my_custom_secret_value_here",
)
# 지정한 시크릿이 그대로 반환됩니다 — 안전하게 보관하세요!
print(result["webhookSecret"])

curl -X POST "https://api.deliveryapi.co.kr/v1/webhooks/endpoints/ep_20260101_120000_a1b2c3d4e5f6a7b8/rotate" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__" \
  -H "Content-Type: application/json" \
  -d '{"webhookSecret": "whsec_my_custom_secret_value_here"}'

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/webhooks/endpoints/ep_20260101_120000_a1b2c3d4e5f6a7b8/rotate',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      webhookSecret: 'whsec_my_custom_secret_value_here'
    })
  }
);
const data = await response.json();
console.log(data.data.webhookSecret); // 지정한 시크릿이 그대로 반환

import requests

response = requests.post(
  "https://api.deliveryapi.co.kr/v1/webhooks/endpoints/ep_20260101_120000_a1b2c3d4e5f6a7b8/rotate",
  headers={
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
  },
  json={
    "webhookSecret": "whsec_my_custom_secret_value_here"
  }
)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

sub = client.webhooks.subscriptions.register(
    items=[
        {"courierCode": "cj", "trackingNumber": "123456789012", "clientId": "order-12345"},
    ],
    recurring=True,
    endpoint_id="ep_20260101_120000_a1b2c3d4e5f6a7b8",
    metadata={"orderId": "ORD-12345", "customerId": "CUS-999"},
)
print(sub["requestId"])

curl -X POST "https://api.deliveryapi.co.kr/v1/webhooks/register" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__" \
  -d '{
    "endpointId": "ep_20260101_120000_a1b2c3d4e5f6a7b8",
    "items": [
      {
        "courierCode": "cj",
        "trackingNumber": "123456789012",
        "clientId": "order-12345"
      }
    ],
    "recurring": true,
    "metadata": {
      "orderId": "ORD-12345",
      "customerId": "CUS-999"
    }
  }'

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/webhooks/register',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    },
    body: JSON.stringify({
      endpointId: 'ep_20260101_120000_a1b2c3d4e5f6a7b8',
      items: [
        {
          courierCode: 'cj',
          trackingNumber: '123456789012',
          clientId: 'order-12345'
        }
      ],
      recurring: true,
      metadata: {
        orderId: 'ORD-12345',
        customerId: 'CUS-999'
      }
    })
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.post(
  "https://api.deliveryapi.co.kr/v1/webhooks/register",
  headers={
    "Content-Type": "application/json",
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
  },
  json={
    "endpointId": "ep_20260101_120000_a1b2c3d4e5f6a7b8",
    "items": [
      {
        "courierCode": "cj",
        "trackingNumber": "123456789012",
        "clientId": "order-12345"
      }
    ],
    "recurring": True,
    "metadata": {
      "orderId": "ORD-12345",
      "customerId": "CUS-999"
    }
  }
)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

result = client.webhooks.subscriptions.list(status="active", limit=20)
print(result["subscriptions"])

curl -X GET "https://api.deliveryapi.co.kr/v1/webhooks/subscriptions?status=active&limit=20" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/webhooks/subscriptions?status=active&limit=20',
  {
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.get(
  "https://api.deliveryapi.co.kr/v1/webhooks/subscriptions",
  params={"status": "active", "limit": 20},
  headers={
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
  }
)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

detail = client.webhooks.subscriptions.get(
    "req_20260101_120000_b2c3d4e5f6a7b8c9",
)
print(detail["items"])

curl -X GET "https://api.deliveryapi.co.kr/v1/webhooks/subscriptions/req_20260101_120000_b2c3d4e5f6a7b8c9" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const requestId = 'req_20260101_120000_b2c3d4e5f6a7b8c9';
const response = await fetch(
  `https://api.deliveryapi.co.kr/v1/webhooks/subscriptions/${requestId}`,
  {
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);
const data = await response.json();
console.log(data);

import requests

request_id = "req_20260101_120000_b2c3d4e5f6a7b8c9"
response = requests.get(
  f"https://api.deliveryapi.co.kr/v1/webhooks/subscriptions/{request_id}",
  headers={
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
  }
)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

client.webhooks.subscriptions.cancel(
    "req_20260101_120000_b2c3d4e5f6a7b8c9",
)

curl -X DELETE "https://api.deliveryapi.co.kr/v1/webhooks/subscriptions/req_20260101_120000_b2c3d4e5f6a7b8c9" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/webhooks/subscriptions/req_20260101_120000_b2c3d4e5f6a7b8c9',
  {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.delete(
  "https://api.deliveryapi.co.kr/v1/webhooks/subscriptions/req_20260101_120000_b2c3d4e5f6a7b8c9",
  headers={
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
  }
)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

result = client.webhooks.subscriptions.batch_results([
    {"courierCode": "cj", "trackingNumber": "123456789012"},
    {"courierCode": "lotte", "trackingNumber": "987654321098"},
])
print(result["results"])

curl -X POST "https://api.deliveryapi.co.kr/v1/webhooks/results" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__" \
  -d '{
    "items": [
      {
        "courierCode": "cj",
        "trackingNumber": "123456789012"
      },
      {
        "courierCode": "lotte",
        "trackingNumber": "987654321098"
      }
    ]
  }'

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/webhooks/results',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    },
    body: JSON.stringify({
      items: [
        {
          courierCode: 'cj',
          trackingNumber: '123456789012'
        },
        {
          courierCode: 'lotte',
          trackingNumber: '987654321098'
        }
      ]
    })
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.post(
  "https://api.deliveryapi.co.kr/v1/webhooks/results",
  headers={
    "Content-Type": "application/json",
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
  },
  json={
    "items": [
      {"courierCode": "cj", "trackingNumber": "123456789012"},
      {"courierCode": "lotte", "trackingNumber": "987654321098"}
    ]
  }
)
print(response.json())

import hmac
import hashlib
import time
import json

def verify_webhook(raw_body, headers, secret):
    timestamp = headers.get('x-webhook-timestamp')
    signature = headers.get('x-webhook-signature')

    # 타임스탬프 유효성 확인 (5분 이내)
    diff = abs(time.time() - int(timestamp))
    if diff > 300:
        raise Exception('Webhook timestamp expired')

    # 서명 검증
    message = f"{timestamp}.{raw_body}"
    expected = 'sha256=' + hmac.new(
        secret.encode(),
        message.encode(),
        hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(signature, expected):
        raise Exception('Invalid webhook signature')

    return json.loads(raw_body)

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

account = client.courier.accounts.register(
    provider_id="lotte",
    account_id="your_lotte_id",
    account_password="your_lotte_password",
)
print(account["courierAccountKey"])

curl -X POST "https://api.deliveryapi.co.kr/v1/courier/accounts/register" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__" \
  -d '{
    "providerId": "lotte",
    "accountId": "your_lotte_id",
    "accountPassword": "your_lotte_password"
  }'

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/courier/accounts/register',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    },
    body: JSON.stringify({
      providerId: 'lotte',
      accountId: 'your_lotte_id',
      accountPassword: 'your_lotte_password'
    })
  }
);

const data = await response.json();
console.log(data);

import requests

url = "https://api.deliveryapi.co.kr/v1/courier/accounts/register"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}
payload = {
    "providerId": "lotte",
    "accountId": "your_lotte_id",
    "accountPassword": "your_lotte_password"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

accounts = client.courier.accounts.list()
active = [a for a in accounts if a["isActive"]]
print(active)

curl -X GET "https://api.deliveryapi.co.kr/v1/courier/accounts" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/courier/accounts',
  {
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

url = "https://api.deliveryapi.co.kr/v1/courier/accounts"
headers = {
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}

response = requests.get(url, headers=headers)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

detail = client.courier.accounts.get("WYA5Rk2hUGKkYNW5Qnkn")
print(detail)

curl -X GET "https://api.deliveryapi.co.kr/v1/courier/accounts/WYA5Rk2hUGKkYNW5Qnkn" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const accountKey = 'WYA5Rk2hUGKkYNW5Qnkn';
const response = await fetch(
  `https://api.deliveryapi.co.kr/v1/courier/accounts/${accountKey }`,
  {
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

account_key = "WYA5Rk2hUGKkYNW5Qnkn"
url = f"https://api.deliveryapi.co.kr/v1/courier/accounts/{account_key }"
headers = {
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}

response = requests.get(url, headers=headers)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

client.courier.accounts.delete("WYA5Rk2hUGKkYNW5Qnkn")

curl -X DELETE "https://api.deliveryapi.co.kr/v1/courier/accounts/WYA5Rk2hUGKkYNW5Qnkn" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const accountKey = 'WYA5Rk2hUGKkYNW5Qnkn';
const response = await fetch(
  `https://api.deliveryapi.co.kr/v1/courier/accounts/${accountKey }`,
  {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

account_key = "WYA5Rk2hUGKkYNW5Qnkn"
url = f"https://api.deliveryapi.co.kr/v1/courier/accounts/{account_key }"
headers = {
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}

response = requests.delete(url, headers=headers)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

result = client.courier.deliveries.inquiry(
    courier_account_key="YOUR_ACCOUNT_KEY",
    from_date="2026-01-01",
    to_date="2026-01-31",
)
print(result["items"])
print(result["summary"])

curl -X POST "https://api.deliveryapi.co.kr/v1/courier/deliveries/inquiry" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__" \
  -d '{
    "courierAccountKey": "YOUR_ACCOUNT_KEY",
    "fromDate": "2026-01-01",
    "toDate": "2026-01-31"
  }'

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/courier/deliveries/inquiry',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    },
    body: JSON.stringify({
      courierAccountKey: 'YOUR_ACCOUNT_KEY',
      fromDate: '2026-01-01',
      toDate: '2026-01-31'
    })
  }
);

const data = await response.json();
console.log(data.data.items);

import requests

url = "https://api.deliveryapi.co.kr/v1/courier/deliveries/inquiry"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}
payload = {
    "courierAccountKey": "YOUR_ACCOUNT_KEY",
    "fromDate": "2026-01-01",
    "toDate": "2026-01-31"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

stats = client.courier.deliveries.dashboard(
    courier_account_key="YOUR_ACCOUNT_KEY",
    from_date="2026-01-01",
    to_date="2026-01-31",
)
print(stats["summary"])

curl -X GET "https://api.deliveryapi.co.kr/v1/courier/deliveries/dashboard?courierAccountKey=YOUR_ACCOUNT_KEY&fromDate=2026-01-01&toDate=2026-01-31" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const params = new URLSearchParams({
  courierAccountKey: 'YOUR_ACCOUNT_KEY',
  fromDate: '2026-01-01',
  toDate: '2026-01-31'
});

const response = await fetch(
  `https://api.deliveryapi.co.kr/v1/courier/deliveries/dashboard?${params }`,
  {
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

url = "https://api.deliveryapi.co.kr/v1/courier/deliveries/dashboard"
headers = {
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}
params = {
    "courierAccountKey": "YOUR_ACCOUNT_KEY",
    "fromDate": "2026-01-01",
    "toDate": "2026-01-31"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

result = client.courier.deliveries.bulk_upload(
    courier_account_key="YOUR_ACCOUNT_KEY",
    items=[{
        "clientOrderId": "ORDER-001",
        "receiverName": "홍길동",
        "receiverPhone1": "01012345678",
        "receiverAddress": "서울특별시 중구 세종대로 110",
        "productName": "애플망고 3kg",
        "quantity": 1,
        "deliveryMessage": "부재시 경비실에 맡겨주세요",
    }],
)
failed = [r for r in result["results"] if not r["success"]]
print(f"등록: {result['totalUploaded']}건, 실패: {result['totalFailed']}건")

curl -X POST "https://api.deliveryapi.co.kr/v1/courier/deliveries/bulk-upload" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__" \
  -d '{
    "courierAccountKey": "YOUR_ACCOUNT_KEY",
    "items": [
      {
        "clientOrderId": "ORDER-001",
        "receiverName": "홍길동",
        "receiverPhone1": "01012345678",
        "receiverPhone2": "",
        "receiverAddress": "서울특별시 중구 세종대로 110",
        "receiverDetailAddress": "1층",
        "receiverZipCode": "04524",
        "senderName": "",
        "senderPhone1": "",
        "senderPhone2": "",
        "senderAddress": "",
        "senderDetailAddress": "",
        "senderZipCode": "",
        "productName": "애플망고 3kg",
        "quantity": 1,
        "deliveryMessage": "부재시 경비실에 맡겨주세요"
      }
    ]
  }'

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/courier/deliveries/bulk-upload',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    },
    body: JSON.stringify({
      courierAccountKey: 'YOUR_ACCOUNT_KEY',
      items: [
        {
          clientOrderId: 'ORDER-001',
          receiverName: '홍길동',
          receiverPhone1: '01012345678',
          receiverPhone2: '',
          receiverAddress: '서울특별시 중구 세종대로 110',
          receiverDetailAddress: '1층',
          receiverZipCode: '04524',
          senderName: '',
          senderPhone1: '',
          senderPhone2: '',
          senderAddress: '',
          senderDetailAddress: '',
          senderZipCode: '',
          productName: '애플망고 3kg',
          quantity: 1,
          deliveryMessage: '부재시 경비실에 맡겨주세요'
        }
      ]
    })
  }
);

const data = await response.json();
console.log(data);

import requests

url = "https://api.deliveryapi.co.kr/v1/courier/deliveries/bulk-upload"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}
payload = {
    "courierAccountKey": "YOUR_ACCOUNT_KEY",
    "items": [
        {
            "clientOrderId": "ORDER-001",
            "receiverName": "홍길동",
            "receiverPhone1": "01012345678",
            "receiverPhone2": "",
            "receiverAddress": "서울특별시 중구 세종대로 110",
            "receiverDetailAddress": "1층",
            "receiverZipCode": "04524",
            "senderName": "",
            "senderPhone1": "",
            "senderPhone2": "",
            "senderAddress": "",
            "senderDetailAddress": "",
            "senderZipCode": "",
            "productName": "애플망고 3kg",
            "quantity": 1,
            "deliveryMessage": "부재시 경비실에 맡겨주세요"
        }
    ]
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

result = client.courier.deliveries.histories.list(
    provider_id="lotte",
    from_date="2026-01-01",
    to_date="2026-01-31",
)
completed = [h for h in result["histories"] if h["status"] == "completed"]
print(completed)

curl -X GET "https://api.deliveryapi.co.kr/v1/courier/deliveries/bulk-upload-histories?providerId=lotte&fromDate=2026-01-01&toDate=2026-01-31" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const params = new URLSearchParams({
  providerId: 'lotte',
  fromDate: '2026-01-01',
  toDate: '2026-01-31'
});

const response = await fetch(
  `https://api.deliveryapi.co.kr/v1/courier/deliveries/bulk-upload-histories?${params }`,
  {
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);

const data = await response.json();
console.log(data.data.histories);

import requests

url = "https://api.deliveryapi.co.kr/v1/courier/deliveries/bulk-upload-histories"
headers = {
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}
params = {
    "providerId": "lotte",
    "fromDate": "2026-01-01",
    "toDate": "2026-01-31"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

result = client.courier.deliveries.histories.get(
    "20260320_1430_abc12",
    courier_account_key="YOUR_ACCOUNT_KEY",
)
delivered = [d for d in result["detailItems"] if d["isDelivered"]]
print(result["history"])
print(f"배송완료: {len(delivered)}건")

curl -X GET "https://api.deliveryapi.co.kr/v1/courier/deliveries/bulk-upload-histories/20260320_1430_abc12/detail?courierAccountKey=YOUR_ACCOUNT_KEY" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__"

const historyId = '20260320_1430_abc12';
const response = await fetch(
  `https://api.deliveryapi.co.kr/v1/courier/deliveries/bulk-upload-histories/${historyId }/detail?courierAccountKey=YOUR_ACCOUNT_KEY`,
  {
    headers: {
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    }
  }
);

const data = await response.json();
console.log(data.data.detailItems);

import requests

history_id = "20260320_1430_abc12"
url = f"https://api.deliveryapi.co.kr/v1/courier/deliveries/bulk-upload-histories/{history_id }/detail"
headers = {
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}
params = {
    "courierAccountKey": "YOUR_ACCOUNT_KEY"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

# pip install deliveryapi 으로 설치하면 Python에서 바로 사용할 수 있어요
from deliveryapi import DeliveryAPIClient

client = DeliveryAPIClient(
    api_key="__API_KEY__",
    secret_key="__SECRET_KEY__",
)

session = client.courier.print.create_session(
    courier_account_key="YOUR_ACCOUNT_KEY",
    provider_id="lotte",
    courier_tracking_ids=["7705241632", "7705241633"],
)
print(session["sessionId"])
# 출력 URL: https://print.deliveryapi.co.kr?session={sessionId}

curl -X POST "https://api.deliveryapi.co.kr/v1/courier/print/sessions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer __API_KEY__:__SECRET_KEY__" \
  -d '{
    "courierAccountKey": "YOUR_ACCOUNT_KEY",
    "providerId": "lotte",
    "courierTrackingIds": ["7705241632", "7705241633"]
  }'

const response = await fetch(
  'https://api.deliveryapi.co.kr/v1/courier/print/sessions',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    },
    body: JSON.stringify({
      courierAccountKey: 'YOUR_ACCOUNT_KEY',
      providerId: 'lotte',
      courierTrackingIds: ['7705241632', '7705241633']
    })
  }
);

const data = await response.json();
console.log(data);

import requests

url = "https://api.deliveryapi.co.kr/v1/courier/print/sessions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer __API_KEY__:__SECRET_KEY__"
}
payload = {
    "courierAccountKey": "YOUR_ACCOUNT_KEY",
    "providerId": "lotte",
    "courierTrackingIds": ["7705241632", "7705241633"]
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

// 1단계: 서버에서 세션 생성 (API 키는 서버에서만 사용)
const res = await fetch(
  'https://api.deliveryapi.co.kr/v1/courier/print/sessions',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer __API_KEY__:__SECRET_KEY__'
    },
    body: JSON.stringify({
      courierAccountKey: 'YOUR_ACCOUNT_KEY',
      providerId: 'lotte',
      courierTrackingIds: ['7705241632', '7705241633']
    })
  }
);
const { data: { sessionId } } = await res.json();

// 2단계: 클라이언트에서 세션 ID로 출력 페이지 열기
window.open(
  `https://print.deliveryapi.co.kr?session=${sessionId}`,
  'print',
  'width=1200,height=800'
);

// 출력 결과 수신 (선택)
window.addEventListener('message', (e) => {
  if (e.data.type === 'delivery-print-complete') {
    console.log('출력 완료:', e.data.success);
    console.log('대상 ID:', e.data.courierTrackingIds);
  }
});