TEAM 연어

Salmonbus 기술 문서

연어버스는 경기 광역버스 1650·3330의 탑승 예보 서비스다. 이 사이트는 좌석 예보·탑승 판정·대기열 추정의 기술 문서를 모은다. 현재 자료를 앞세우고, API 초안은 보존 문서로 남긴다.

수집 정상 · 오늘 API 호출 46회 · 일일 평가 2일째 · 만석 누적 173건 · 승자 없음

배포 시점 값 · 일일 평가 2026-08-16분 · 생성 08-17 00:15 KST

지금 보는 것

확정

팀 레포 origin/dev의 Route·Board·Vehicle DTO와 계약 테스트를 기준으로 오류 응답·오류 코드·staleAt과 순번 설명을 v4-1로 개정했다. OpenAPI 판본은 2.1.0이다.

과거

08번 후보(차량 상태 조건부 좌석 분포)를 채택할 경우에 필요하다고 제안했던 개정안. 선택 필드를 더하는 증분안이 아니라 /board를 다시 만드는 파괴적 변경이다. 당시 확정 계약은 아래 v3이었고 이것은 검토 요청이었다 — 구현 머지로 위의 v4-1이 됐다.

예보의 주어가 바뀐다 — 지금 오고 있는 그 버스가 그 정류장에 도착할 때 몇 석 남는지
/board를 재구성한다 — 정류장당 확률 하나를 도착 예정 차량별 확률로 바꾼다
파괴적 변경이라 프론트엔드 수정이 필요하다. 정류장 골격과 /routes·/vehicles는 스키마가 그대로이고, 노선 메타는 방향마다 첫차·막차 시각이 는다

과거

2026-08-17 팀 검토로 확정했던 계약. v4-1 확정 전까지 구현의 기준이었다.