지하철 특정 호선 지하철역 정보 조회

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

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

상세기능 번호	1	상세기능 유형	조회 (자료)
상세기능명(국문)	서울교통공사 지하철정보
상세기능 설명	특정호선-지하철역 정보
Call Back URL	https://i48ojxo10p.apigw.ntruss.com/public-station/v1/subway-info/line-{line_num}	line_num	1~8
평균 응답 시간	500 ms	초당 최대 트랙잭션	30 tps

Path variable

Path variable(각 URI 내 중괄호({}) 로 묶인 경로 변수)는 아래 내용을 참고하여 호출 시 누락되지 않도록 해주세요.

name	desc	value
line_num	지하철 호선 번호	1~8

지하철 특정 호선 지하철역 정보 조회 API

GET https://4vh6qtie3c.apigw.ntruss.com/public-station/v1/subway-info/line-{line_num}

Headers

Name	Type	Description
Authorization*	string	사용자ID;secret key

200: OK 응답 반환 완료

Response Body

No	출력명	출력설명
공통	list_total_count	총 데이터 건수 (정상조회 시 출력됨)
공통	RESULT.CODE	요청결과 코드 (하단 메세지설명 참고)
공통	RESULT.MESSAGE	요청결과 메시지 (하단 메세지설명 참고)
1	STATION_CD	전철역코드
2	STATION_NM	전철역명
3	STATION_NM_ENG	전철명명(영문)
4	LINE_NUM	호선
5	FR_CODE	외부코드
33	STATION_NM_CHN	전철명명(중문)
34	STATION_NM_JPN	전철명명(일문)

요청 및 응답 예시

URI

https://i48ojxo10p.apigw.ntruss.com/public-station/v1/subway-info/line-1

Response

{
  "SearchSTNBySubwayLineInfo": {
      "list_total_count": 2,
      "row": [
          {
              "STATION_NM": "온양온천",
              "STATION_NM_ENG": "Onyang oncheon",
              "STATION_CD": 1407,
              "LINE_NUM": "01호선",
              "STATION_NM_JPN": "溫陽溫泉",
              "FR_CODE": "P176",
              "STATION_NM_CHN": "溫陽溫泉"
          },
          {
              "STATION_NM": "신창",
              "STATION_NM_ENG": "Sinchang",
              "STATION_CD": 1408,
              "LINE_NUM": "01호선",
              "STATION_NM_JPN": "新昌",
              "FR_CODE": "P177",
              "STATION_NM_CHN": "新昌"
          }
      ],
      "RESULT": {
           "MESSAGE": "정상 처리되었습니다",
           "CODE": "INFO-000"
      }
  }
}

CODE 명세

CODE	MESSAGE
INFO-000	정상 처리되었습니다
ERROR-300	필수 값이 누락되어 있습니다. 요청인자를 참고 하십시오.
INFO-100	인증키가 유효하지 않습니다. 인증키가 없는 경우, 열린 데이터 광장 홈페이지에서 인증키를 신청하십시오.
ERROR-301	파일타입 값이 누락 혹은 유효하지 않습니다. 요청인자 중 TYPE을 확인하십시오.
ERROR-310	해당하는 서비스를 찾을 수 없습니다. 요청인자 중 SERVICE를 확인하십시오.
ERROR-331	요청시작위치 값을 확인하십시오. 요청인자 중 START_INDEX를 확인하십시오.
ERROR-332	요청종료위치 값을 확인하십시오. 요청인자 중 END_INDEX를 확인하십시오.
ERROR-333	요청위치 값의 타입이 유효하지 않습니다. 요청위치 값은 정수를 입력하세요.
ERROR-334	요청종료위치 보다 요청시작위치가 더 큽니다. 요청시작조회건수는 정수를 입력하세요.
ERROR-335	샘플데이터(샘플키:sample) 는 한번에 최대 5건을 넘을 수 없습니다. 요청시작위치와 요청종료위치 값은 1 ~ 5 사이만 가능합니다.
ERROR-336	데이터요청은 한번에 최대 1000건을 넘을 수 없습니다. 요청종료위치에서 요청시작위치를 뺀 값이 1000을 넘지 않도록 수정하세요.
ERROR-500	서버 오류입니다. 지속적으로 발생시 열린 데이터 광장으로 문의(Q&A) 바랍니다.
ERROR-600	데이터베이스 연결 오류입니다. 지속적으로 발생시 열린 데이터 광장으로 문의(Q&A) 바랍니다.
ERROR-601	SQL 문장 오류 입니다. 지속적으로 발생시 열린 데이터 광장으로 문의(Q&A) 바랍니다.
INFO-200	해당하는 데이터가 없습니다.