일반 부가서비스¶
MaaS 메뉴와 해당 서비스의 지원 역을 조회합니다. 메뉴 링크는 데이터로만 반환하며 제휴 서비스의 신청·예약·결제를 수행하지 않습니다.
list_maas_menus¶
반환값 · MaasMenuListResponse
승차권과 무관한 일반 부가서비스 메뉴를 조회합니다. 인자는 없으며 items는 MaasMenuItem tuple입니다.
| 주요 필드 | 의미 |
|---|---|
name, info, url |
메뉴 이름·설명·링크 |
active, menu_type, app_data |
서버가 제공하는 메뉴 상태와 구분 |
additional_service_code |
지원 역 조회에 사용하는 서비스 코드 |
login_required |
해당 제휴 서비스의 이용 조건. SDK의 로그인 상태가 아님 |
uses_station_selection |
활성·메뉴 구분·앱 데이터·서비스 코드 조건으로 판단한 역 선택 사용 여부 |
MaasMenuListResponse는 응답에 포함된 안내 URL도 보존합니다. 필드가 존재한다고 모든 메뉴가 계정 없이 이용 가능한 것은 아닙니다. 여기서 확인하는 것은 메뉴 조회 범위입니다.
list_maas_stations¶
반환값 · StationDataResponse
서비스 코드 하나의 지원 역을 조회합니다. 인자는 비어 있지 않은 문자열이며 일반 메뉴에서 uses_station_selection이 참인 항목의 additional_service_code를 사용합니다. 응답의 stations는 KorailStation tuple입니다.
기존 실서버 관측은 코드 510의 역 101개였습니다. 다른 코드나 제휴 서비스 동작까지 확인한 결과는 아닙니다. 메뉴에서 코드 선택하기의 예제와 모델 레퍼런스를 참고하세요.