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’ 생성 시 키를 발급 받을 수 있습니다.

상세기능 번호

3

상세기능 유형

조회

상세기능명

getBusRouteList

상세기능 설명

노선번호에 해당하는 노선 목록 조회

Call Back URL

https://i48ojxo10p.apigw.ntruss.com/public-busroute/v1/bus-route-list

최대 메시지 사이즈

3MB

평균 응답 시간

100 ms

초당 최대 트랜잭션

30 tps

버스 노선 번호 목록 조회 API

GET https://4vh6qtie3c.apigw.ntruss.com/public-busroute/v1/bus-route-list

Query Parameters

Name
Type
Description

strSrch*

number

검색할 노선 번호

Headers

Name
Type
Description

Authorization*

string

사용자ID;secret key

Response Body

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

ServiceResult

조회 결과

Y

조회 결과

comMsgHeader

공통메시지 헤더

128

N

특이사항

공통메시지 헤더

headerCd

헤더 코드

1

Y

0

결과 코드

headerMsg

헤더 메시지

128

Y

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

결과 메시지

msgBody

본문 내용

Y

본문 내용

itemList

각 항목 리스트

Y

각 항목 리스트

itemCount

항목 개수

1

Y

0

항목 개수

busRouteAbrv

노선 약칭

128

Y

12345

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

busRouteId

노선 ID

9

Y

100000010

노선 ID

busRouteNm

노선명

128

Y

12345

노선명 (DB관리용)

length

노선 길이 (Km)

10

Y

0

노선 길이 (Km)

routeType

노선 유형

1

Y

0

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

stStationNm

기점

128

Y

경복고교

기점

edStationNm

종점

128

Y

청와대분수대앞

종점

term

배차간격 (분)

10

Y

10

배차간격 (분)

lastBusYn

막차운행여부

1

Y

Y

막차운행여부

firstBusTm

금일첫차시간

14

Y

20170809040000

금일첫차시간

lastBusTm

금일막차시간

14

Y

20170809230000

금일막차시간

firstLowTm

금일저상첫차시간

14

Y

20170809040000

금일저상첫차시간

lastLowTm

금일저상막차시간

14

Y

20170809230000

금일저상막차시간

corpNm

운수사명

128

Y

BMS온라인메뉴얼

운수사명

요청 및 응답 예시

https://i48ojxo10p.apigw.ntruss.com/public-busroute/v1/bus-route-list?strSrch=3

{
  "ServiceResult": {
      "comMsgHeader": "",
      "msgHeader": {
           "headerCd": 0,
           "headerMsg": "정상적으로 처리되었습니다.",
           "itemCount": 0
      },
      "msgBody": {
           "itemList": [
              {
                  "firstLowTm": "",
                  "busRouteAbrv": 6003,
                  "lastLowTm": 20191105000000,
                  "corpNm": "공항리무진  02-2664-9898",
                  "length": 156,
                  "lastBusTm": 20230319225000,
                  "busRouteNm": 6003,
                  "stStationNm": "인천공항",
                  "lastBusYn": "",
                  "edStationNm": "서울대학교",
                  "term": 30,
                  "firstBusTm": 20230319042000,
                  "routeType": 1,
                  "busRouteId": 100100414
              },
              {
                  "firstLowTm": "",
                  "busRouteAbrv": 6013,
                  "lastLowTm": "",
                  "corpNm": "공항리무진  02-2664-9898",
                  "length": 167,
                  "lastBusTm": 20230319225000,
                  "busRouteNm": 6013,
                  "stStationNm": "인천공항",
                  "lastBusYn": "",
                  "edStationNm": "홈플러스면목점",
                  "term": 40,
                  "firstBusTm": 20230319042000,
                  "routeType": 1,
                  "busRouteId": 100100420
              }
          ]
      }
  }
}

오류코드

오류코드
오류

0

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

1

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

2

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

3

정류소를 찾을 수 없습니다

4

노선을 찾을 수 없습니다.

5

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

6

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

7

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

8

운행 종료되었습니다.

Was this helpful?