Skip to content

Releases: bobhyun/TS-API

v1.0.2

13 May 09:38
@bobhyun bobhyun
release/v1.0.2
61cffce

Choose a tag to compare

View all tags
v1.0.2 Latest
Latest

Relative URLs in v1 Responses

URL fields in v1 responses are now relative paths (/...). v0 endpoints keep absolute URLs (http://{host}/...) for backward compatibility.

Affected v1 fields: src, videoSrc, image, images[], faceImg, orgImg.

Why: absolute URLs embedded the request's Host: header verbatim, so a reverse proxy rewriting Host: baked the wrong hostname into the URL. Relative paths also align with future multi-NVR group routing.

Client compatibility:

  • Browsers: no change — relative URLs resolve against the page origin.
  • Non-browser clients (curl, mobile, server-to-server): prepend the API base URL before fetching.

Exceptions:

  • v0 absolute URL host comes from Canonical Host (Web Admin → Server Settings → API), falling back to the X-Host header.
  • /api/v1/vod live stream URLs (RTMP / WebSocket-FLV) remain absolute.

Breaking Changes

None.

v1 응답 URL 상대 경로화

v1 응답의 URL 필드를 상대 경로 (/...) 로 변경했습니다. v0 엔드포인트는 절대 URL (http://{host}/...) 을 유지합니다 (하위 호환).

영향 필드: src, videoSrc, image, images[], faceImg, orgImg.

배경: 기존 절대 URL 은 요청의 Host: 헤더를 그대로 사용해서, 리버스 프록시가 Host: 를 재작성하면 잘못된 호스트가 URL 에 박혔습니다. 향후 다중 NVR 그룹 라우팅과도 정렬됩니다.

클라이언트 호환성:

  • 브라우저: 변경 불필요 — 상대 URL 이 페이지 origin 에 자동 결합됩니다.
  • 비-브라우저 (curl, 모바일, 서버 간 통신): fetch 전 base URL 을 결합해야 합니다.

예외:

  • v0 절대 URL 의 host 는 Canonical Host (웹 관리자 → 서버 설정 → API) 값을 사용하고, 없으면 X-Host 헤더로 fallback.
  • /api/v1/vod 라이브 스트림 URL (RTMP / WebSocket-FLV) 은 절대 URL 유지.

Breaking Changes

없음.

Assets 2
Loading

v1.0.1

09 Apr 00:44
@bobhyun bobhyun
release/v1.0.1
8c61fed

Choose a tag to compare

View all tags
v1.0.1

LPR Event: Batch Plate Array (WebSocket)

Multiple plates recognized in a single frame are now delivered as one event with a plates array, instead of separate events per plate.

{
  "topic": "LPR",
  "channel": 1,
  "image": "/storage/lpr/...",
  "plates": [
    {"plateNo":"12가3456","score":95,"srcCode":"A01",...},
    {"plateNo":"34나5678","score":88,"srcCode":"A02",...}
  ]
}

Client compatibility — handle both formats:

const plates = data.plates || [data];
plates.forEach(p => console.log(p.plateNo, p.score));

Note: This format applies to v1 WebSocket (/wsapi/v1/events) only. v0 WebSocket (/wsapi/subscribeEvents) continues to use the legacy single-plate format.

Parking Spot Improvements (WebSocket)

  • Vehicle info always included: vehicle field is now populated whenever plate data exists, regardless of parking lot registration.
  • Duplicate event fix: A single recognition no longer triggers two parkingSpot events. Occupancy + vehicle data are combined into one event.

Breaking Changes

None. All changes are backward compatible.

LPR 이벤트: 번호판 배열 형식 (WebSocket)

한 프레임에서 여러 번호판이 인식된 경우, 개별 이벤트 대신 plates 배열로 하나의 이벤트에 통합 전송합니다.

{
  "topic": "LPR",
  "channel": 1,
  "image": "/storage/lpr/...",
  "plates": [
    {"plateNo":"12가3456","score":95,"srcCode":"A01",...},
    {"plateNo":"34나5678","score":88,"srcCode":"A02",...}
  ]
}

클라이언트 호환 처리 — 구/신 형식 모두 대응:

const plates = data.plates || [data];
plates.forEach(p => console.log(p.plateNo, p.score));

참고: 이 형식은 v1 WebSocket (/wsapi/v1/events)에만 적용됩니다. v0 WebSocket (/wsapi/subscribeEvents)은 기존 단일 plate 형식을 유지합니다.

주차면 이벤트 개선 (WebSocket)

  • 차량 정보 항상 포함: 주차장 등록 여부와 관계없이 번호판 인식 데이터가 있으면 vehicle 필드를 전송합니다.
  • 중복 이벤트 수정: 한 번의 인식에서 parkingSpot 이벤트가 두 번 발생하던 문제를 수정하여 하나의 이벤트로 통합합니다.

Breaking Changes

없음. 모든 변경사항은 하위 호환됩니다.

Loading