PARKING 24 파트너 API 문서

파트너 API는 PARKING 24와 협약된 파트너사가 자사 서비스에서 주차 예약을 생성하고 관리할 수 있도록 제공하는 HTTP API입니다.

Quickstart — 5분 첫 호출

API 키 발급부터 첫 검색 응답까지 5분 안에 검증하는 절차입니다.

1. Sandbox 키 발급 (1분)

파킹24 파트너스 /partner/api-keys 에서 Sandbox 토글 ON 으로 새 키 생성. 키 prefix 가 pk24_test_ 인지 확인. 생성 직후 1회만 plain key가 표시되므로 즉시 저장합니다.

파트너 포털 계정이 아직 없으면 "통합 문의 / 연락처" 섹션 참조 — 담당자에게 계정 + 키 발급 요청.

2. 인증 헤더 + 첫 검색 (2분)

KST 기준 미래 날짜 + 공항 UUID 로 검색합니다. 공항 UUID 는 /partner/api-guide Playground 의 "공항 chip" 에 표시됩니다.

curl -sS "https://parking24.me/api/partner-api/v1/search\
?airport_id=YOUR_AIRPORT_UUID\
&checkin_date=2026-06-01\
&checkout_date=2026-06-03" \
  -H "Authorization: Bearer pk24_test_YOUR_TEST_KEY"

성공 응답 예시 — plans[] 가 채워져 있으면 인증/공항 매칭 모두 OK 입니다.

{
  "success": true,
  "data": {
    "plans": [
      {
        "plan_id": "550e8400-e29b-41d4-a716-446655440000",
        "plan_name": "Standard",
        "original_price": 60000,
        "discounted_price": 54000,
        "available_quantity": null,
        "services": [],
        "ev_restricted": false
      }
    ],
    "total_days": 3,
    "surcharges": null
  },
  "error": null
}

실패 시 error_code 값을 보고 분기:

• AUTH_REQUIRED / INVALID_API_KEY → 헤더/키 확인
• AIRPORT_NOT_AVAILABLE → 공항 UUID 확인 또는 파트너 visible_airport_ids 권한 확인
• INVALID_DATE → KST 미래 날짜 + YYYY-MM-DD 형식 확인

3. 다음 단계 (2분)

위 검색이 성공하면 같은 키로 예약 생성 (POST /reservations) → 조회 (GET /reservations) → 취소 (PATCH /reservations) 순으로 검증합니다. 각 엔드포인트 상세는 본문 아래 섹션 참조. 통합 검증이 끝나면 "통합 문의 / 연락처" 로 Live 키 발급 요청.

🧪 Sandbox 예약은 실 정산·매출에서 자동 제외됩니다. 코드 변경 없이 키 prefix 만 pk24_live_ 로 교체하면 Live 전환 완료.

Base URL & 버전

• Base URL: https://parking24.me
• 권장 prefix: /api/partner-api/v1/... (예: https://parking24.me/api/partner-api/v1/reservations)
• 무버전 경로 /api/partner-api/... 도 현재 동일 동작하지만 2026-11-14 이후 deprecation 예정(6개월 윈도우). 신규 통합은 반드시 /v1/ 사용.
• 응답 형식·인증·rate limit·헤더 모두 동일. 라우팅 alias만 차이.

OpenAPI / Postman

자동화 친화 — OpenAPI 3.0 spec 을 그대로 import 해서 클라이언트 SDK / Postman collection 을 자동 생성할 수 있습니다.

• OpenAPI 3.0 yaml: https://parking24.me/docs/partner-api/openapi.yaml (무인증 공개, 1시간 캐시)
• Postman 에서 import: File → Import → Link → 위 URL 붙여넣기 → Continue

OpenAPI Generator / Swagger Codegen 등과 호환됩니다 (/v1/ prefix 의 server 가 default).

인증

모든 요청에 아래 헤더를 포함해야 합니다.

• API 키는 파킹24 파트너스 (https://parking24.me/partner/api-keys) 에서 발급합니다.
• 키 prefix 가 환경을 결정합니다. 자세한 내용은 "Sandbox & Live 환경" 섹션 참조.
• 키 노출 시 즉시 어드민 담당자에게 재발급을 요청하세요.

Sandbox & Live 환경

파트너 API 는 Sandbox (테스트) 와 Live (운영) 두 환경을 같은 베이스 URL 로 제공합니다. 환경은 API 키 prefix 로 결정됩니다 — 코드 분기 불필요, 키만 교체.

키 prefix

키 발급

파킹24 파트너스 https://parking24.me/partner/api-keys 에서:

1. "새 API 키" 버튼 → 키 이름 입력
2. Sandbox 토글 선택 (운영 키는 OFF, 테스트 키는 ON)
3. 생성 직후 1회만 plain key 표시 — 안전한 곳에 저장 필수
4. 키 목록에 TEST / LIVE 배지로 환경 구분

Sandbox 예약 동작

Sandbox 키로 만든 예약은 실 예약 시스템 동작과 완전 동일합니다. 다음 차이만 있습니다:

⚠️ Sandbox 예약은 실제 주차 서비스가 제공되지 않습니다. 차량번호·연락처·이름은 테스트 더미 값을 사용하세요.

Webhook payload 분기

수신 측에서 sandbox 이벤트를 분리 처리하려면 data.is_sandbox 필드를 확인:

app.post('/webhook', (req, res) => {
  const { event, data } = req.body;
  if (data.is_sandbox) {
    // 테스트 트래픽 — staging DB 저장 또는 무시
    console.log('sandbox event:', event);
    return res.status(200).end();
  }
  // live 트래픽 처리
});

권장 통합 단계

1. Sandbox 키 발급 — 파킹24 파트너스에서 sandbox 토글로 발급
2. 로컬/staging 통합 — 모든 시나리오 검증
   • 검색 → 예약 생성 → 조회 → 취소
   • 쿠폰 검증 → 적용
   • Webhook 수신 + 서명 검증
   • 에러 코드별 분기 (error_code enum)
3. Webhook URL 등록 — sandbox endpoint 또는 logging-only endpoint 로 설정
4. Live 키 발급 요청 — PARKING 24 어드민 담당자에게 운영 키 발급 요청 (수동 승인)
5. Live 전환 — 환경 변수만 교체 (pk24_test_* → pk24_live_*). 코드 변경 없음

주의사항

• 데이터 격리는 키 단위가 아닌 partner_id 단위: 같은 파트너의 sandbox 키 / live 키 는 같은 partner_id 를 공유합니다. 다른 파트너의 예약은 어느 키로도 조회 불가.
• 실 사용자 데이터 금지: sandbox 예약에 실 차량번호/연락처/이메일 사용 금지. 마케팅·결제 시스템과 분리되지 않는 데이터.
• 혼용 금지: 같은 서비스 인스턴스에서 sandbox/live 키 혼용 시 정산 혼선 위험. 환경 변수로 강제 분리 권장 (예: PARKING24_API_KEY 단일 ENV + 환경별 배포).
• 키 폐기는 영구적: sandbox 키도 한번 폐기하면 복구 불가. 발급·폐기는 파트너 포털 UI 에서 직접 관리.

공통 응답 형식

모든 응답은 아래 JSON 구조를 따릅니다.

{
  "success": true,
  "data": { ... },
  "error": null
}

공통 규약 (timezone / currency / Idempotency)

Timezone

• 모든 날짜(checkin_date, checkout_date 등 YYYY-MM-DD 형식)는 한국 표준시(Asia/Seoul, UTC+09:00) 기준입니다. 시차 변환은 제휴사 측에서 처리하지 않아도 됩니다.
• 모든 시각(checkin_time, checkout_time 등 HH:MM 형식) 역시 KST 기준입니다.
• 모든 타임스탬프(created_at, updated_at, expires_at, webhook timestamp 등)는 ISO 8601 UTC 형식으로 반환됩니다. 엔드포인트별로 Z suffix(2026-03-10T01:00:00.000Z) 또는 +00:00 offset(2026-03-10T01:00:00.000+00:00)이 사용되며 둘은 동일한 UTC 시각을 의미합니다 (표준 ISO 8601 파서로 모두 처리 가능). UTC를 KST로 변환하려면 +9시간 적용.

Currency

• 모든 금액 필드(original_price, discounted_price, total_price, cancellation_fee, discount_amount, parking24_cost, partner_cost, final_price 등)는 대한민국 원(KRW) 단위의 정수입니다. 소수점·통화기호·자릿수 구분자 없이 정수로만 반환됩니다.
• 모든 통화는 KRW로 고정되며 별도 currency 필드는 응답에 포함되지 않습니다.

Idempotency-Key (재시도 안전성)

mutation 엔드포인트(POST /reservations, PATCH /reservations, POST /coupon/apply)에 Idempotency-Key 헤더를 함께 보내면 동일 키로 24시간 내 재호출 시 첫 응답이 그대로 재생됩니다. 네트워크 오류·timeout 후 안전한 재시도 보장.

권장: 클라이언트에서 UUID v4를 생성하여 사용. 키 길이 1~255자. 같은 키를 다른 사용자 데이터(예: 다른 차량번호)로 재사용하지 마세요 — 422가 반환됩니다.

응답 헤더 X-P24-Timing (디버깅·SLO)

모든 partner-api 응답에는 단계별 처리 시간을 담은 X-P24-Timing 헤더가 포함됩니다. 형식은 W3C Server-Timing 사양을 따르되 헤더 이름만 커스텀(X- prefix)을 사용합니다.

각 name;dur=ms 토큰의 의미:

용도:

• 클라이언트측 SLO 모니터링 — 평균/p95 latency를 자체 대시보드로 추적
• 디버깅 — 응답이 느릴 때 어느 단계가 병목인지 즉시 확인
• 외부 제휴사 자동화 — 측정값을 외부 알람(Datadog, PagerDuty 등)에 연결 가능

참고: Vercel runtime이 표준 Server-Timing 헤더를 자체 처리/덮어쓰는 동작이 있어 커스텀 X-P24-Timing을 사용합니다. 값 형식은 표준과 동일하므로 동일 파서로 처리 가능합니다.

에러 코드

실패 응답 예시:

{
  "success": false,
  "data": null,
  "error": "airport_id, checkin_date, checkout_date are required",
  "error_code": "MISSING_FIELD"
}

error_code enum (자동화 분기용)

응답 body에 error_code 필드가 함께 반환됩니다. 사람 가독 error 메시지는 시간이 지나면서 변경될 수 있지만 error_code는 stable합니다. 외부 제휴사 자동화에서 분기/알람용으로 사용하세요.

기존 error 텍스트 필드는 호환을 위해 유지되며 로깅·UI 표시용으로 활용 가능합니다.

엔드포인트

1. 주차 이용권 검색

특정 공항과 날짜 범위에서 예약 가능한 이용권 목록과 파트너 적용 가격을 반환합니다.

GET /api/partner-api/search

쿼리 파라미터

응답 (200 OK)

{
  "success": true,
  "data": {
    "plans": [
      {
        "plan_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "plan_name": "Standard",
        "original_price": 75000,
        "discounted_price": 67500,
        "available_quantity": null,
        "services": ["실외 주차", "기본 보관"],
        "ev_restricted": false
      },
      {
        "plan_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "plan_name": "Exclusive",
        "original_price": 200000,
        "discounted_price": 180000,
        "available_quantity": 5,
        "services": ["전용 구역", "프리미엄 세차", "차량 정비", "보험", "라운지 이용권"],
        "ev_restricted": false
      }
    ],
    "total_days": 5,
    "surcharges": {
      "T1": { "base_surcharge": 5000, "night_surcharge": 3000, "night_start": 19, "night_end": 5 },
      "T2": { "base_surcharge": 7000, "night_surcharge": 3000, "night_start": 19, "night_end": 5 }
    }
  },
  "error": null
}

응답 필드 설명 (data)

plans[*] 필드

curl 예시

curl -X GET \
  "https://parking24.me/api/partner-api/search?airport_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890&checkin_date=2026-03-10&checkout_date=2026-03-15" \
  -H "Authorization: Bearer pk24_live_your_api_key_here"

2. 예약 생성

지정한 이용권으로 새 예약을 생성합니다. 생성된 예약은 booking_source: PARTNER_API로 기록됩니다. booking_source는 서버에서 자동 생성되는 읽기 전용 필드이며, 요청 시 전송할 필요가 없습니다.

POST /api/partner-api/reservations

요청 Body (application/json)

{
  "airport_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "plan_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "checkin_date": "2026-03-10",
  "checkout_date": "2026-03-15",
  "checkin_time": "10:00",
  "checkout_time": "18:00",
  "terminal": "T1",
  "customer_name": "홍길동",
  "customer_phone": "010-1234-5678",
  "car_number": "12가3456",
  "is_electric_vehicle": false,
  "memo": "트렁크에 짐 있음"
}

요청 필드 설명

응답 (201 Created)

{
  "success": true,
  "data": {
    "reservation_number": "PK20260310001",
    "status": "CONFIRMED",
    "checkin_date": "2026-03-10",
    "checkin_time": "10:00",
    "checkout_date": "2026-03-15",
    "checkout_time": "18:00",
    "total_price": 180000,
    "plan_name": "Exclusive",
    "customer_name": "홍길동",
    "car_number": "12가3456",
    "memo": "트렁크에 짐 있음"
  },
  "error": null
}

응답 필드 설명

curl 예시

curl -X POST \
  "https://parking24.me/api/partner-api/reservations" \
  -H "Authorization: Bearer pk24_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "airport_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "plan_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "checkin_date": "2026-03-10",
    "checkout_date": "2026-03-15",
    "checkin_time": "10:00",
    "checkout_time": "18:00",
    "customer_name": "홍길동",
    "customer_phone": "010-1234-5678",
    "car_number": "12가3456",
    "memo": "트렁크에 짐 있음"
  }'

3. 예약 조회

파트너가 생성한 예약 목록을 조회합니다. 예약 번호나 상태로 필터링하거나 페이지네이션을 사용할 수 있습니다.

GET /api/partner-api/reservations

쿼리 파라미터

응답 (200 OK)

{
  "success": true,
  "data": {
    "reservations": [
      {
        "id": "f1e2d3c4-b5a6-7890-fedc-ba9876543210",
        "reservation_number": "PK20260310001",
        "airport_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "plan_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "exclusive_lot_id": null,
        "customer_name": "홍길동",
        "car_number": "12가3456",
        "checkin_date": "2026-03-10",
        "checkin_time": "10:00",
        "checkout_date": "2026-03-15",
        "checkout_time": "18:00",
        "terminal": "T1",
        "memo": "트렁크에 짐 있음",
        "total_days": 5,
        "price_per_day": 36000,
        "partner_discount_amount": 18000,
        "total_price": 180000,
        "cancellation_fee": 0,
        "status": "CONFIRMED",
        "booking_source": "PARTNER_API",
        "created_at": "2026-02-24T10:00:00.000Z",
        "updated_at": "2026-02-24T10:00:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 20
  },
  "error": null
}

응답 필드 설명 (data)

예약 레코드 필드 (reservations[*])

curl 예시

전체 목록 조회:

curl -X GET \
  "https://parking24.me/api/partner-api/reservations?page=1&limit=20" \
  -H "Authorization: Bearer pk24_live_your_api_key_here"

특정 예약 단건 조회:

curl -X GET \
  "https://parking24.me/api/partner-api/reservations?reservation_number=PK20260310001" \
  -H "Authorization: Bearer pk24_live_your_api_key_here"

상태별 필터 조회:

curl -X GET \
  "https://parking24.me/api/partner-api/reservations?status=CONFIRMED&page=1&limit=20" \
  -H "Authorization: Bearer pk24_live_your_api_key_here"

4. 예약 취소

생성된 예약을 취소합니다. CONFIRMED 또는 CHECKED_IN 상태의 예약만 취소할 수 있습니다.

PATCH /api/partner-api/reservations

요청 Body (application/json)

{
  "reservation_number": "PK20260310001"
}

요청 필드 설명

응답 (200 OK)

{
  "success": true,
  "data": {
    "reservation_id": "f1e2d3c4-b5a6-7890-fedc-ba9876543210",
    "reservation_number": "PK20260310001",
    "status": "CANCELLED",
    "cancellation_fee": 5000,
    "total_price": 60000,
    "refund_amount": 55000
  },
  "error": null
}

응답 필드 설명

취소 불가 조건

아래 상태의 예약은 취소할 수 없으며 400 에러를 반환합니다.

• CANCELLED — 이미 취소된 예약
• COMPLETED — 출차 완료된 예약

curl 예시

curl -X PATCH \
  "https://parking24.me/api/partner-api/reservations" \
  -H "Authorization: Bearer pk24_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "reservation_number": "PK20260310001"
  }'

예약 상태 흐름

5. 쿠폰 검증

쿠폰 코드의 유효성을 검증하고 적용 후 금액을 계산하여 반환합니다. 검색 결과의 discounted_price를 original_price로 넘기는 것을 권장합니다.

POST /api/partner-api/coupon/validate

요청 Body (application/json)

응답 (200 OK)

{
  "success": true,
  "data": {
    "valid": true,
    "coupon_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
    "coupon_code_id": "d2e3f4a5-b6c7-8901-defa-234567890123",
    "discount_amount": 18000,
    "parking24_cost": 12600,
    "partner_cost": 5400,
    "final_price": 162000
  },
  "error": null
}

응답 필드 설명

무효 쿠폰은 success: false + error 메시지(예: "쿠폰이 만료되었습니다")로 400을 반환합니다.

curl 예시

curl -X POST \
  "https://parking24.me/api/partner-api/coupon/validate" \
  -H "Authorization: Bearer pk24_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"code": "SUMMER2026", "original_price": 180000}'

6. 쿠폰 적용

예약에 쿠폰 할인을 적용합니다. 예약 1건당 쿠폰 1개만 적용 가능합니다. 적용 시 파트너 분담액은 settlement_adjustments에 자동 기록됩니다.

POST /api/partner-api/coupon/apply

요청 Body (application/json)

응답 (200 OK)

{
  "success": true,
  "data": {
    "reservation_id": "f1e2d3c4-b5a6-7890-fedc-ba9876543210",
    "coupon_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
    "coupon_code_id": "d2e3f4a5-b6c7-8901-defa-234567890123",
    "discount_amount": 18000,
    "parking24_cost": 12600,
    "partner_cost": 5400,
    "final_price": 162000
  },
  "error": null
}

응답 필드 설명

curl 예시

curl -X POST \
  "https://parking24.me/api/partner-api/coupon/apply" \
  -H "Authorization: Bearer pk24_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SUMMER2026",
    "reservation_id": "f1e2d3c4-b5a6-7890-fedc-ba9876543210",
    "original_price": 180000
  }'

웹훅

파트너에 webhook_url이 등록되어 있으면, 예약 상태 변경 시 이벤트가 전송됩니다.

요청 형식

POST {partner.webhook_url}

이벤트 타입

Payload schema

최상위 envelope:

data 필드:

요청 본문 예시

reservation.confirmed (live 키 예약):

{
  "event": "reservation.confirmed",
  "data": {
    "reservation_id": "f1e2d3c4-b5a6-7890-fedc-ba9876543210",
    "reservation_number": "PK20260310001",
    "airport": "인천국제공항",
    "plan": "Exclusive",
    "checkin_date": "2026-03-10",
    "checkout_date": "2026-03-15",
    "total_price": 180000,
    "customer_name": "홍길동",
    "status": "CONFIRMED",
    "is_sandbox": false
  },
  "timestamp": "2026-03-10T01:00:00.000Z"
}

reservation.cancelled (sandbox 키 예약):

{
  "event": "reservation.cancelled",
  "data": {
    "reservation_id": "f1e2d3c4-b5a6-7890-fedc-ba9876543210",
    "reservation_number": "PK20260310001",
    "airport": "인천국제공항",
    "plan": "Exclusive",
    "checkin_date": "2026-03-10",
    "checkout_date": "2026-03-15",
    "total_price": 180000,
    "cancellation_fee": 5000,
    "customer_name": "홍길동",
    "status": "CANCELLED",
    "is_sandbox": true
  },
  "timestamp": "2026-03-10T01:00:00.000Z"
}

서명 검증

• WEBHOOK_SIGNING_SECRET은 PARKING 24가 관리하는 서버 시크릿. 파트너에게는 미공개이며, 시크릿이 필요할 경우 PARKING 24 파트너 지원팀에 별도 요청하세요.
• Timeout: 5초. 발송 결과는 PARKING 24 내부 webhook_events 테이블에 로그되며, 실패 시에도 예약 처리는 정상 진행됩니다.

Rate Limiting

• 윈도우: 60초 슬라이딩 윈도우
• 기본 한도: API 키당 분당 60회 (파트너별 설정 가능)
• 초과 시: 429 Too Many Requests + Retry-After: 60 헤더
• 정책: Fail-Open (DB 장애 시 요청 허용)

주차 요금 정책

가격 계산 모델

검색 API(GET /api/partner-api/search) 응답의 original_price / discounted_price는 다음 공식으로 산출됩니다.

• base_price, base_days, additional_per_day는 공항×이용권 단위로 PARKING 24 어드민에서 관리되는 운영 값입니다.
• 제휴사는 별도 계산 없이 검색 API의 original_price(정상가 합계) 또는 discounted_price(파트너 할인 적용 후 합계)를 그대로 사용하시는 것을 권장합니다.

인천국제공항(ICN) 현행 운영 기준

⚠️ 아래 값은 2026-05 기준 운영값으로, 실제 적용가는 검색 API 응답을 따릅니다.

Standard (실외) — base_price=50,000 / base_days=5 / additional_per_day=5,000 Pro (실내) — base_price=60,000 / base_days=4 / additional_per_day=10,000

터미널 추가요금

예약 요청 시 terminal 필드(예: T1, T2)를 지정하면 입·출고 시각에 따라 추가요금이 자동 산정됩니다.

추가요금 정책은 검색 API 응답의 surcharges 객체로 노출되며 입출고 각각에 대해 다음 공식이 적용됩니다.

인천국제공항 현행 운영 기준

총 추가요금 = checkin_surcharge + checkout_surcharge (각각 위 공식 적용).

계산 예시 (T2, 입차 22:30, 출차 11:00):

• checkin_surcharge = 10,000 + 10,000(야간) = 20,000원
• checkout_surcharge = 10,000 + 0(주간) = 10,000원
• 합계 추가요금 = 30,000원
• 최종 total_price = (검색 응답 가격) + 30,000

terminal 필드를 생략하면 추가요금은 0원으로 적용됩니다.

전기차 제한

이용권별 ev_restricted 플래그가 true인 경우(실내주차장 등) is_electric_vehicle: true로 예약 생성 시 400을 반환합니다. 검색 API 응답에서 각 이용권의 ev_restricted 값을 확인하세요.

가격 모델 변경 안내

위 운영값은 PARKING 24 어드민에서 수시로 조정될 수 있습니다. 제휴사 측에서 가격을 캐싱하지 마시고, 예약 직전 검색 API를 호출하여 최신 가격을 확인하시기 바랍니다.

파트너 할인 체계

파트너별 할인은 검색 API의 discounted_price에 자동 반영됩니다.

파트너별 공항×이용권 조합으로 세부 가격을 별도 설정할 수 있습니다.

AI/LLM 연동

AI 코딩 도구(Cursor, Claude, Windsurf 등)에서 아래 URL을 컨텍스트에 추가하면 API 연동 코드를 자동 생성할 수 있습니다.

주의 사항

• 날짜 형식은 반드시 YYYY-MM-DD를 사용하세요.
• 시간 형식은 반드시 HH:MM을 사용하세요.
• airport_id와 plan_id는 UUID 형식이어야 합니다.
• 동일 차량 번호로 날짜가 겹치는 예약이 이미 존재할 경우 409 에러가 반환됩니다.
• API는 파트너 계정에 귀속된 예약만 조회 및 취소할 수 있습니다.
• 파트너별 visible_airport_ids, visible_plan_ids 필터가 적용됩니다.

통합 문의 / 연락처

PO 입력 대기 중: 아래 4개 placeholder ({{...}}) 는 partner-api-contact-template.md 결정 후 PO가 직접 편집합니다. 채널이 확정되면 이 안내 블록도 삭제하세요.

응답 시간: {{PARTNER_SUPPORT_HOURS}} / SLA: {{PARTNER_SUPPORT_SLA}}

계정/키 발급 요청 시 포함: 회사명, 사업자번호, 통합 담당자 이름·이메일, 예상 월 트래픽(예약 건수), 서비스 형태(B2B/B2C).

변경 이력은 partner-api-changelog.md 또는 파트너 포털 /partner/dashboard 공지 카드에서 확인하세요. 채널 변경 시 본 문서가 우선 갱신됩니다.