일반적인 규약

웹 서버는 메서드 호출에 대해 JSON 형식으로 응답합니다.

인증

요청을 위해 인증이 필요합니다. 두 가지 인증 방식이 지원됩니다: Basic 인증과 Bearer 인증

Basic 인증 방식에서는 모든 HTTP 요청에 다음과 같은 형식으로 사용자 데이터를 추가해야 합니다.

http://[username]:[password]@[IP-address]:[port]/[prefix]

Bearer 인증 방식에서는 웹 서버에서 받은 토큰을 사용합니다 (Bearer 인증 참조).

POST 요청에는 JSON 본문이 포함되어야 합니다.

요청에서의 시간 형식

모든 요청에서 시간은 UTC+0 시간대의 YYYYMMDDTHHMMSS 형식으로 지정됩니다.

시간 간격은 일부 요청에서 지정됩니다. 예를 들어:

GET http://IP-address:port/prefix/archive/contents/intervals/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME}

이 요청은 BEGINTIME에서 시작하여 ENDTIME에서 끝나는 데이터를 반환합니다.

BEGINTIME이 지정되지 않으면 무한 미래가 적용됩니다. ENDTIME이 지정되지 않으면 무한 과거가 적용됩니다. BEGINTIME과 ENDTIME 대신 "past"와 "future"라는 단어를 사용하여 각각 무한 과거와 무한 미래를 설정할 수 있습니다.

간격 순서는 지정된 BEGINTIME과 ENDTIME 간의 비율에 해당합니다(만약 BEGINTIME<ENDTIME이면 오름차순, ENDTIME<BEGINTIME이면 내림차순). 간격의 시작점과 끝점은 순차적으로 반환되며, 즉, 간격 시작 시간이 간격 종료 시간보다 작거나 같아야 합니다.

요청 제한

활성 요청과 대기 중인 요청의 수에는 제한이 있습니다.

요청이 너무 많을 경우, 503 오류(검색 쿼리 거부. 너무 많은 요청)가 반환됩니다.