API PLEX Developer Guide
ServiceBlog
한국어
한국어
  • API PLEX 개발자 가이드
  • Release Note
    • Release Note
  • Service
    • Biz Message
      • SMS
      • LMS
      • MMS
      • MMS 이미지 업로드
      • 메시지 발송 결과(WebHook)
    • RCS
      • SMS
      • LMS
      • MMS
      • 캐러셀
      • 템플릿
      • 이미지 업로드 API
      • 메시지 발송 결과 (WebHook)
      • 참조코드 및 값 분류
        • RCS 결과 코드
        • 메시지 발송 응답 코드
        • GATEWAY 오류코드
        • message base ID
    • Kakao Message
      • 알림톡
      • 친구톡
      • 이미지 업로드 API
      • Failback
      • 메시지 발송 결과 (WebHook)
    • Naver Message
      • 네이버 톡톡
      • 네이버 톡톡 (광고성)
    • Global Message
      • GMS
        • GMS (v2)
        • GMS (v1)
        • 메세지 발송 결과(WebHook)
        • 참조 코드
          • 메시지 상태 코드
          • 서비스 오류 코드
      • WhatsApp
      • Viber
    • Email
      • 이메일 스탠다드
      • 이메일 유효검사
    • Push
      • 앱푸시
        • 앱푸시 일괄발송
        • 앱푸시 단건발송
      • 웹푸시
        • 웹푸시 구독 신청
        • 웹푸시 일괄 발송
    • Additional Service
      • 080 수신거부
      • Fax
  • MarketPlace
    • Public API Market
      • 버스 노선 정보 조회 서비스
        • 노선 기본 정보 항목 조회
        • 노선 경로 목록 조회
        • 노선 번호 목록 조회
        • 노선 별 경유 정류소 목록 조회
      • 버스 위치 정보 조회 서비스
        • 특정 정류소 버스 위치 정보 조회
        • 노선 버스 위치 정보 목록 조회
        • 특정 차량 위치 정보 조회
        • 교통 약자 전용-특정 정류소 버스 위치 정보 목록 조회
        • 교통 약자 전용-노선 버스 위치 정보 목록 조회
      • 부동산 거래 신고된 아파트의 전월세 정보 조회
      • 지하철 특정 호선 역 간 거리 및 소요 시간 조회
      • 지하철 특정 호선 지하철역 정보 조회
      • 병원 정보 조회
      • 약국 정보 조회 서비스
        • 약국 목록 정보 조회
        • 약국 위치 정보 조회
        • 약국 별 기본정보 조회
        • 약국 FullData 내려받기
      • 미세먼지 경보 발령 현황 조회
    • AI Market
      • OpenAI
        • chatGPT 3.5 Turbo
Powered by GitBook
On this page
  • 버스 기본 노선 정보 조회 API
  • Response Body
  • 요청 및 응답 예시
  • 오류코드

Was this helpful?

  1. MarketPlace
  2. Public API Market
  3. 버스 노선 정보 조회 서비스

노선 기본 정보 항목 조회

캐릭터 인코딩은 UTF-8 을 기본으로 합니다.

secret key는 ‘서비스콘솔’ – ‘Sub Account’ 생성 시 키를 발급 받을 수 있습니다.

상세기능 번호

1

상세기능 유형

조회

상세기능명

getRouteInfoItem

상세기능 설명

노선 기본정보 조회 아이디에 해당하는 노선정보를 반환한다.

Call Back URL

https://i48ojxo10p.apigw.ntruss.com/public-busroute/v1/route-info-item

최대 메시지 사이즈

3MB

평균 응답 시간

100 ms

초당 최대 트랙잭션

30 tps

버스 기본 노선 정보 조회 API

GET https://4vh6qtie3c.apigw.ntruss.com/public-busroute/v1/route-info-item

Query Parameters

Name
Type
Description

busRouteId*

number

노선 시스템 ID(9자리 숫자)

Headers

Name
Type
Description

Authorization*

string

사용자ID;secret key

Response Body

항목명(영문)
항목명(국문)
항목크기
필수
샘플데이터
항목설명

ServiceResult

조회 결과

1

Y

조회 결과

comMsgHeader

공통메시지 헤더

128

N

특이사항

공통메시지 헤더

headerCd

헤더 코드

1

Y

0

결과 코드

headerMsg

헤더 메시지

128

Y

정상적으로 처리되었습니다.

결과 메시지

itemCount

항목 개수

1

Y

0

항목 개수

msgBody

본문 내용

1

Y

본문 내용

itemList

각 항목 리스트

Y

각 항목 리스트

busRouteAbrv

노선 약칭

128

Y

1225

노선명 (안내용 – 마을버스 제외)

busRouteId

노선 ID

9

Y

100100112

노선 ID

busRouteNm

노선명

128

Y

1225

노선명 (DB관리용)

length

노선 길이

10

Y

43.3

노선 길이 (Km)

routeType

노선 유형

1

Y

3

노선 유형 (1:공항, 2:마을, 3:간선, 4:지선, 5:순환, 6:광역, 7:인천, 8:경기, 9:폐지, 0:공용)

stStationNm

기점

128

Y

북가좌동

기점

edStationNm

종점

128

Y

건대입구역

종점

term

배차간격 (분)

10

Y

8

배차간격 (분)

lastBusYn

막차운행여부

1

Y

Y

막차운행여부

firstBusTm

금일첫차시간

14

Y

20170809042000

금일첫차시간

lastBusTm

금일막차시간

14

Y

20170809224000

금일막차시간

firstLowTm

금일저상첫차시간

14

Y

20170313000000

금일저상첫차시간

lastLowTm

금일저상막차시간

14

Y

20170809224000

금일저상막차시간

corpNm

운수사명

128

Y

서부운수 02-372-0221

운수사명

요청 및 응답 예시

https://i48ojxo10p.apigw.ntruss.com/public-busroute/v1/route-info-item?busRouteId=100100112

{
  "ServiceResult": {
      "comMsgHeader": "",
      "msgHeader": {
           "headerCd": 0,
           "headerMsg": "정상적으로 처리되었습니다.",
           "itemCount": 0
      },
      "msgBody": {
           "itemList": {
              "firstLowTm": 20170313000000,
              "busRouteAbrv": 721,
              "lastLowTm": "",
              "corpNm": "서부운수  02-372-0221",
              "length": 43.3,
              "lastBusTm": 20230319224000,
              "busRouteNm": 721,
              "stStationNm": "북가좌동",
              "lastBusYn": "",
              "edStationNm": "건대입구역",
              "term": 8,
              "firstBusTm": 20230319042000,
              "routeType": 3,
              "busRouteId": 100100112
          }
      }
  }
}

오류코드

오류코드
오류

0

정상적으로 처리되었습니다

1

시스템 오류가 발생하였습니다

2

잘못된 쿼리 요청입니다. 쿼리 변수가 정확한지 확인하세요.

3

정류소를 찾을 수 없습니다

4

노선을 찾을 수 없습니다.

5

잘못된 위치로 요청을 하였습니다. 위/경도 좌표가 정확한지 확인하세요

6

실시간 정보를 읽을 수 없습니다. 잠시 후 다시 시도하세요

7

경로 검색 결과가 존재하지 않습니다.

8

운행 종료되었습니다.

Was this helpful?