Skip to content

docs: add a reproducible Seoul subway verification sample (#4) - #5

Merged
tahodev merged 7 commits into
mainfrom
seoul-subway-verification-sample
Sep 22, 2026
Merged

tahodev merged 7 commits into
mainfrom
seoul-subway-verification-sample

Conversation

@tahodev

@tahodev tahodev commented Sep 19, 2026

Copy link
Copy Markdown
Owner

Closes #4.

確認したもの

  • 公式ソース(ソウル交通公社, swopenapi.seoul.go.kr)で実在路線を実データ確認: 列車位置API realtimePosition がサンプルキーのまま動くことを 2026-09-19 に実測。
    • 1号線: INFO-000, 走行中78〜79編成(例: 종로3가駅, trainNo 0638, recptnDt 2026-09-19 12:43:42)
    • 2号線: INFO-000, 37編成
  • 到着予測API(realtimeStationArrival)はサンプルキーでは ERROR-336 で、従来どおり無料の実キーが必要(今回も再現)。

変更内容

  • seoul-subway/SKILL.md に「再現可能な実データ確認例」を追加: 実行コマンド・期待する主要フィールド・確認日、サンプルキーの範囲癖(0/5 ちょうどのみ成功)、空レスポンス/認証エラー/海外ランナー制限の見分け方
  • README の検証マトリクス: seoul-subway を「実データ応答確認」へ移動(到着APIは実キー必要と明記)
  • CHANGELOG(Unreleased/Changed)と docs/features ガイドの注記を更新

完了条件

  • 記載コマンドはすべて実行済み(結果は上記)
  • ログイン不要・読み取り専用を維持
  • scripts/lint-skills.sh 通過

The per-station arrival API (realtimeStationArrival) still needs a real
key (sample key returns ERROR-336), but the sibling realtimePosition API
returns live train positions with the sample key when the range is
exactly 0/5. Verified 2026-09-19 against Line 1 (78-79 trains) and
Line 2 (37 trains): INFO-000 with subwayNm/statnNm/trainNo/recptnDt.

Adds the command, expected fields, sample-key range quirk, and how to
tell empty response vs auth error vs overseas-runner blocking. Updates
the README verification matrix, CHANGELOG, and the feature guide note.
@tahodev
tahodev merged commit 79885de into main Sep 22, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: add a reproducible Seoul subway verification sample

1 participant