Service
출발지와 목적지로 예상 요금을 조회하고, 실제 택시를 호출하고, 배차 상태를 추적하고, 필요하면 취소할 수 있습니다.
99.71%30일 가동률평균 응답246ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/swing-taxi/cancel_ride | Cancels a dispatched taxi ride call. Use when the user wants to cancel a taxi that was called with swing-taxi:dispatch_taxi; requires that ride's ride_call_id. Do NOT use to check whether a ride is still active — use swing-taxi:get_ride_status instead. Returns result (ok when the cancellation is accepted) and a Korean summary. | |
| POST | /v1/swing-taxi/dispatch_taxi | Dispatches a real taxi to the pickup address — this creates a live ride call with real cost and starts searching for a driver. Use only when the user explicitly asks to call or book a taxi and the passenger name, Korean mobile phone number, and a stable external_user_id are available; origin and destination each require an address. Do NOT use for price or travel-time quotes — use swing-taxi:estimate_fare instead. Returns ride_call_id (needed by swing-taxi:get_ride_status and swing-taxi:cancel_ride), the fare estimate, Kakao Map links, and the parameters used. Only standard taxis (MEDIUM) are currently supported; DELUXE, LARGE, and LUXURY are unavailable. | |
| POST | /v1/swing-taxi/estimate_fare | Estimates the taxi fare, travel time, and route distance between an origin and a destination. Use when the user wants to know how much a taxi would cost or how long the trip would take; each point accepts an address or a lat/lng pair, and taxi_call_type is optional. Do NOT use to actually call a taxi — use swing-taxi:dispatch_taxi instead. Returns estimate_price, toll_fare, distance, total_time, the resolved coordinates, Kakao Map links, and a Korean summary. Only standard taxis (MEDIUM) are currently supported; DELUXE, LARGE, and LUXURY are unavailable. | |
| POST | /v1/swing-taxi/get_ride_status | Checks the current status of a dispatched ride call. Use after swing-taxi:dispatch_taxi with its ride_call_id to track dispatch progress, driver allocation, boarding, and completion. Do NOT use to cancel the ride — use swing-taxi:cancel_ride instead. Returns status, status_phase, status_text, estimate_driver_time, and driver details (name, phone, vehicle, photo, live map link) once a driver is allocated. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
