서울교통공사_열차시간표

서울교통공사 열차시간표 API는 서울지하철의 열차 시간표 정보를 조회할 수 있는 API입니다. 상하행, 내외선 및 주말 구분을 포함한 역별 열차 운행 시간 정보를 제공하며, 역코드, 역번호, 역명, 지선명, 호선명, 열차 번호, 출도착 시각, 임시 시간표 여부, 급행 여부 및 환승 가능 여부 등의 항목을 포함합니다. 출발역과 도착역 기준의 열차시간표 확인, 교통정보 서비스 연계 등에 활용될 수 있습니다. 열차시간표는 수시로 갱신되는 정보를 Rest API 방식으로 제공합니다. 데이터는 수시로 갱신됩니다.

body header 결과메세지 결과코드 급행여부 기준일자 (일자형식: YYYYMMDD) 데이터 총 개수 도착 지하철 역명 도착 지하철 역번호 도착 지하철 역코드 도착 지하철 호선명 서울지하철 열차번호 서울지하철 열차종류 연결열차번호 열차시간표 조회 데이터 유효시작일시 (일시형식: YYYY-MM-DDThh:mm:ss) 유효종료일시 (일시형식: YYYY-MM-DDThh:mm:ss) 임시시간표여부 조회 데이터 배열 주말구분 지선명 지하철 도착시각 지하철 상하행 구분 지하철 출발시각 출발 지하철 역명 출발 지하철 역번호 출발 지하철 호선명 출발 해당 지하철 역코드 페이지 결과 수 페이지 번호 해당 지하철 역명 해당 지하철 역번호 해당 지하철 역코드 호선명

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '결과 유형 (JSON/XML=값' \
  --data-urlencode 'default:XML)=값' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '상하행구분 (상행/하행/내선/외선)=값' \
  --data-urlencode '유효시작일시인 시간표만 반환하도록 하는 검색어(일시형식: YYYY-MM-DDThh:mm:ss)=json' \
  --data-urlencode '응답으로 받고 싶은 컬럼 명을 선택하여 검색(구분자‘=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "결과 유형 (JSON/XML": "값",
  "default:XML)": "값",
  "공공데이터포털에서 받은 인증키": "값",
  "상하행구분 (상행/하행/내선/외선)": "값",
  "유효시작일시인 시간표만 반환하도록 하는 검색어(일시형식: YYYY-MM-DDThh:mm:ss)": "json",
  "응답으로 받고 싶은 컬럼 명을 선택하여 검색(구분자‘": "값",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "결과 유형 (JSON/XML": "값",
    "default:XML)": "값",
    "공공데이터포털에서 받은 인증키": "값",
    "상하행구분 (상행/하행/내선/외선)": "값",
    "유효시작일시인 시간표만 반환하도록 하는 검색어(일시형식: YYYY-MM-DDThh:mm:ss)": "json",
    "응답으로 받고 싶은 컬럼 명을 선택하여 검색(구분자‘": "값",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())