API Reference
택배사 목록 조회
ApiFuse가 지원하는 택배사 목록을 반환합니다.
택배사 목록 조회
CJ대한통운, 한진, 롯데, 우체국, 로젠 5개 택배사의 ID와 이름을 반환합니다.
엔드포인트
GET /v1/delivery-carriers
Upstream
- Base URL: ``
- Path:
/carriers
요청 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
country_code | string | ❌ | - | 국가 코드 필터 (예: kr) |
요청 예시
{}응답 스키마
아래 스키마는 adapter의 Zod output schema에서 직접 생성됩니다.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"carriers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"carrier_id": {
"type": "string"
},
"name": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"carrier_id",
"name",
"country"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
}
},
"required": [
"carriers",
"total"
],
"additionalProperties": false
}응답 예시
{
"data": {
"carriers": [
{
"carrier_id": "kr.cjlogistics",
"name": "CJ대한통운",
"country": "kr"
},
{
"carrier_id": "kr.hanjin",
"name": "한진택배",
"country": "kr"
},
{
"carrier_id": "kr.lotte",
"name": "롯데택배",
"country": "kr"
},
{
"carrier_id": "kr.epost",
"name": "우체국택배",
"country": "kr"
},
{
"carrier_id": "kr.logen",
"name": "로젠택배",
"country": "kr"
}
],
"total": 5
},
"pagination": null,
"meta": {
"source": "delivery-carriers",
"fetchedAt": "2026-03-24T00:00:00.000Z"
}
}