Seoul Subway Arrival

職業

カテゴリ

Backend

1. Stop for secure registration when the API key is missing

평문 key를 붙여 넣지 않는다.

SEOUL_OPEN_API_KEY, ~/.config/k-skill/secrets.env, ~/.config/k-skill/age/keys.txt 중 하나라도 없으면 다음 식으로 안내하고 멈춘다.

이 작업에는 SEOUL_OPEN_API_KEY 가 필요합니다.
값을 채팅창에 붙여 넣지 말고 ~/.config/k-skill/secrets.env.plain 에 직접 채운 뒤
sops 로 ~/.config/k-skill/secrets.env 로 암호화해 주세요.
암호화가 끝나면 plaintext 파일은 지우고 bash scripts/check-setup.sh 로 다시 확인해 주세요.

시크릿이 없다는 이유로 비공식 미러 API나 다른 출처로 자동 우회하지 않는다.

SOPS_AGE_KEY_FILE="$HOME/.config/k-skill/age/keys.txt" \
sops exec-env "$HOME/.config/k-skill/secrets.env" 'test -n "$SEOUL_OPEN_API_KEY"'

2. Query the official station arrival endpoint

서울 실시간 지하철 API는 역명 기준 실시간 도착 정보를 JSON/XML로 제공한다. 기본 질의 예시는 다음 패턴을 쓴다.

SOPS_AGE_KEY_FILE="$HOME/.config/k-skill/age/keys.txt" \
sops exec-env "$HOME/.config/k-skill/secrets.env" \
  'curl -s "http://swopenAPI.seoul.go.kr/api/subway/${SEOUL_OPEN_API_KEY}/json/realtimeStationArrival/0/8/강남"'

3. Summarize the response

가능하면 아래 항목만 먼저 요약한다.

• 호선
• 상/하행 또는 외/내선
• 첫 번째 도착 메시지
• 두 번째 도착 메시지
• 도착 예정 시간(있으면 초 단위)

4. Be conservative about live data

실시간 데이터는 몇 초 단위로 바뀔 수 있으므로, 답변에는 조회 시점을 같이 적는다.

Done when

• 요청 역의 도착 예정 열차가 정리되어 있다
• live data 기준 시점이 명시되어 있다
• key가 노출되지 않았다

Failure modes

• API key 미설정
• quota 초과
• 역명 표기 불일치

Notes

• 서울 열린데이터 광장 가이드는 실시간 지하철 Open API에 일일 호출 제한이 있을 수 있다고 안내한다
• endpoint path는 API 버전 변경 가능성이 있으므로 실패 시 dataset console의 최신 샘플 URL을 다시 확인한다