Service
카카오 계정을 연결하면 장소 검색, 현장결제 호출 옵션 비교, 카카오 T 택시 호출·조회·취소를 사용할 수 있습니다.
아직 측정 데이터가 없습니다. 제공이 시작되면 이 섹션에서 가동 상태를 확인할 수 있습니다.
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | 카카오 T 진행 중 호출 | /v1/kakaot/active-rides | Lists the Kakao T taxi rides currently active for the connected account. Use when a kakaot:request-ride response was lost or the ride ID is unknown. Do NOT use to poll a ride whose ID you already have — use kakaot:ride-status instead. Returns rides, which is an empty list when there is no active ride. Requires a Kakao T connection. |
| POST | /v1/kakaot/cancel-ride | Cancels a Kakao T ride request using the appropriate action for its current state. Use when the user asks to cancel a requested or dispatched taxi. Do NOT use only to check the cancellation fee — use kakaot:cancellation-policy instead. Cancellation may incur a fee after a driver is assigned; call kakaot:cancellation-policy and confirm with the user first. Returns ride_id and cancelled. Requires a Kakao T connection. | |
| POST | /v1/kakaot/cancellation-policy | Fetches the cancellation fee notice Kakao T shows for a ride. Use before kakaot:cancel-ride and relay the notice to the user. Do NOT use to cancel the ride — use kakaot:cancel-ride instead. Returns notices and an optional title. Requires a Kakao T connection. | |
| POST | /v1/kakaot/connection-health | 정상 연결의 카카오 T 사용자 식별자를 반환합니다. | |
| POST | /v1/kakaot/request-ride | Requests an immediate on-site-payment taxi for one service_type offered under a ride_option_token from kakaot:ride-options. Use only after the user has confirmed the route and estimate. Do NOT use to check fares or availability — use kakaot:ride-options instead. APIFuse rechecks that no ride is active and that service, payment eligibility, and fare are unchanged. Retrying with the same ride_option_token returns the original ride instead of dispatching twice. Card details are never accepted. This dispatches a real taxi. Returns ride_id. Requires a Kakao T connection. | |
| POST | /v1/kakaot/reverse-geocode | Reverse-geocodes coordinates into a Kakao T address and nearby place and returns it under a short location_token with location_key "1" for ride-option lookup. Use when the user picks a point on a map or supplies coordinates. Do NOT use for a keyword, address text, or landmark name — use kakaot:search-address instead. Returns location_token, location, and expires_at. Requires a Kakao T connection. | |
| POST | /v1/kakaot/ride-options | Lists currently available on-site-payment taxi services and estimated fares for a route. origin and destination each take the location_token from kakaot:search-address or kakaot:reverse-geocode plus the location_key of the chosen row. Use when the user wants a fare estimate or must choose a service before requesting a taxi. Do NOT use to dispatch a taxi — use kakaot:request-ride with the returned ride_option_token and a listed service_type instead. One short ride_option_token keeps the route, every offered service, and the confirmed estimates server-side, so coordinates and internal IDs are not copied into the next call. Returns ride_options, plus ride_option_token, route, and expires_at when at least one option is available. Requires a Kakao T connection. | |
| POST | /v1/kakaot/ride-status | Fetches the current status of a requested Kakao T ride by ride_id. Use after kakaot:request-ride until a driver is assigned or the request ends. Do NOT use when the ride ID is unknown — use kakaot:active-rides instead. Returns ride_id, status, and status_updated_at when Kakao T reports it as an ISO 8601 timestamp with a UTC offset. Requires a Kakao T connection. | |
| POST | /v1/kakaot/search-address | Searches Kakao T places and addresses by keyword and returns one normalized location list. Use when the user names a place, address, or landmark. Do NOT use for a point picked on a map or raw coordinates — use kakaot:reverse-geocode instead. The response carries one short location_token for the whole result set and a plain location_key on every row; upstream place IDs remain private. Pass the location_token together with the chosen location_key to kakaot:ride-options. An optional near coordinate biases the search toward that point. Returns location_token, locations, and expires_at. Requires a Kakao T connection. |
key가 호출할 수 있는 서비스와 API의 범위를 정의합니다.
멱등한 호출의 재시도 규칙과 backoff 동작을 설명합니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
