# RailNow · 실시간 열차 정보

> 열차 번호와 노선으로 수도권 전철의 현재 위치, 다음 역, 지연, 행선지를 실시간 도착정보(수 분 간격 수집)와 시각표 보정(화면 15초 갱신)으로 조회하는 무료 웹 서비스이자 개발자용 REST API.

## 사용자용 조회
- 직접 링크: https://railnow.runvia.app/?line={노선ID}&train={열차번호} (예: https://railnow.runvia.app/?line=1001&train=K802)
- 메인: https://railnow.runvia.app/ (열차 조회 / 노선별 조회 / 역별 조회)

## 개발자용 무료 API
- 개발자 센터(API 키 발급): https://railnow.runvia.app/developer
- Swagger 문서: https://railnow.runvia.app/api/docs
- 인증: 요청 헤더 X-API-Key
- GET /api/v1/train/lines : 조회 가능한 노선 목록
- GET /api/v1/train/{열차번호}?lineId={노선ID} : 열차 실시간 정보

## English guide
- Seoul subway train tracking: https://railnow.runvia.app/en
- API documentation (English Swagger): https://railnow.runvia.app/api/docs/en
- OpenAPI 3.0.3 spec (English): https://railnow.runvia.app/api/docs/en/json
- The live app currently uses Korean labels. Coverage is limited to supported lines in South Korea.