Service
NOL 숙소 재고를 찾고 실시간 객실 요금을 조회하며, 회원 주문서를 준비하고, 완료된 공식 예약을 대사하며, 버전이 지정된 환불 조건으로 취소 견적을 내거나 취소를 실행합니다.
76.21%30일 가동률평균 응답346ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/nol/cancel-booking | Irreversibly cancels a confirmed or confirmation-pending NOL booking after re-fetching official terms and matching the supplied terms_version. Use only after the caller has reviewed nol:get-cancellation-quote and confirmed the cancellation. Do NOT use to preview fees or refunds — use nol:get-cancellation-quote instead. Sends the documented reason code `other` with the caller's reason_detail. Returns booking and cancellation. | |
| POST | /v1/nol/create-quote | Revalidates one offer_id from the offers_token list against the member web session and the NOL domestic order sheet. Use when the member has chosen an offer from nol:list-offers and needs a reviewable quote before booking. Do NOT use to prepare the order sheet or to start payment — use nol:prepare-booking and nol:start-checkout instead. It does not book or pay. Returns status, an attempt_token handle that prepare-booking commits once, and a summary with price, cancellation, visit-type, and payment-method details. | |
| POST | /v1/nol/get-booking | Gets a connection-owned booking by booking_id and reconciles an order-sheet-ready intent against official NOL order history. Use when the caller needs the current official status of one booking, for example after payment in NOL's official flow. Do NOT use to list all bookings — use nol:list-bookings instead. Do NOT use to compute cancellation fees — use nol:get-cancellation-quote instead. Returns the booking record with status, provider_order_id, and provider_status. | |
| POST | /v1/nol/get-cancellation-quote | Fetches the official cancellation policy and preview for a confirmed or confirmation-pending booking. Use before nol:cancel-booking to review the fee and refund and to obtain the required terms_version. Do NOT use to actually cancel — use nol:cancel-booking instead. Returns cancelable and partial_cancelable flags, items, payments, paid_amount_krw, the current cancellation_fee_krw, estimated_refund_krw, terms_version, and quoted_at. |
key가 호출할 수 있는 서비스와 API의 범위를 정의합니다.
멱등한 호출의 재시도 규칙과 backoff 동작을 설명합니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
지난 30일 동안 이 서비스에서 관측된 기록입니다.
| POST | /v1/nol/get-stay-detail | Gets normalized metadata for one NOL stay for exact dates and guests without a member session: name, address, description, coordinates, overnight and day-use prices, and sold-out flags. Use when the caller already has a stay_id and needs stay-level information. Do NOT use for keyword or coordinate discovery — use nol:search-stays instead. Do NOT use to list rooms and rate plans — use nol:list-room-rate-plans instead. Returns the normalized stay detail. |
| POST | /v1/nol/list-bookings | Lists the booking intents stored for this NOL connection, newest first, without exposing internal order-sheet payloads. Use when the caller needs booking_id values or an overview of the connection's bookings. Do NOT use to refresh one booking's official status — use nol:get-booking instead. Returns items of booking records. |
| POST | /v1/nol/list-offers | Uses the connected member web session to flatten the currently available room rate plans of a NOL stay into one offered list accepted by nol:create-quote. Use when the member is ready to choose a room to quote. Do NOT use for anonymous price browsing — use nol:list-room-rate-plans instead. Returns one offers_token handle for the whole list, valid for 10 minutes on this connection, plus items, each with a plain offer_id key, room and rate-plan identity, dates, prices, and a cancellation summary. |
| POST | /v1/nol/list-room-rate-plans | Lists rooms and exact current rate plans for a NOL stay without a member session, including availability, prices, times, versions, and cancellation summaries. Use when the caller only needs to browse rooms and prices. Do NOT use to obtain bookable offer_id values — use nol:list-offers instead. Returns stay, rooms, and pricing_context. |
| POST | /v1/nol/prepare-booking | Commits an approved quote attempt_token once and prepares a connection-scoped order-sheet-ready booking record; a retried call returns the same booking instead of preparing a second one. Use after nol:create-quote, supplying visit_type when the quote requires it. Do NOT use to obtain payment form fields — use nol:start-checkout instead. This operation does NOT place an upstream reservation; payment must be completed in NOL's official flow, after which nol:get-booking reconciles the resulting order. Returns the booking record with booking_id, status, and total_price_krw. |
| POST | /v1/nol/search-stays | Searches NOL domestic stays by query, with strict accommodation-type, stay-type, star-rating, availability, price, and sort filters. Use when the caller needs to discover stays by keyword. Nearby search by coordinates is not available right now and fails with NEARBY_SEARCH_UNAVAILABLE. Do NOT use to look up one known stay — use nol:get-stay-detail instead. Returns normalized stay identity, location description, reviews, separate overnight and day-use prices, promoted status, sold-out signals, and a page_token handle for the next page that expires after 10 minutes. star_rating filters hotels by grade: fivestar, fourstar, threestar, twostar or onestar; omit for all grades. |
| POST | /v1/nol/start-checkout | Revalidates a prepared member booking and returns short-lived form fields for NOL's official payment flow. Use after nol:prepare-booking with a method listed in the create-quote summary; guest optionally replaces the connected account identity placed in the form. Do NOT use to check whether the booking was paid or confirmed — use nol:get-booking instead. Submit the fields only in the payer's browser or WebView; this operation does not pay, confirm, or change the booking status. Returns status, payment_method, action_url, http_method, content_type, form_fields, and expires_at. |
