소개

개요

API URLhttps://api.spoot.kr
API tokenhttps://view.spoot.kr 접속 > 로그인 > 프로필 > 상세 페이지에서 token을 복사하여 사용

HTTP 응답

코드	설명
200	Function successfully executed.
400	Invalid API location. Check the URL that you are using.
403	Invalid or missing API key. Check that your API key is present and matches your assigned key.
405	Invalid HTTP method. Check that the method (POST / GET)
412	Request failed. Check the response body for a more detailed description.
500	Internal server error. Try again at a later time.
503	Rate limit hit. API requests are limited to an average of 1/s. Try your request again later.

녹화 영상 목록

GET /v1/record/list content_copy

녹화된 영상 목록 조회

Header

Parameter

page페이지 번호 / 선택
limit페이지당 목록 수 / 선택
search검색어 / 선택(device_label 검색, 포함 검색)
dev_id디바이스 ID / 선택(ALL:전체, 반드시 일치해야 검색)
cate미디어 구분 / 선택(P:실시간/H:수동실시간/N:일반/S:SOS)
file_type파일 종류 / 선택(M:동영상/V:음성/I:이미지)
rec_start_dt녹화 시작일 / 선택(yyyy-MM-dd HH:mm:ss)
rec_end_dt녹화 종료일 / 선택(yyyy-MM-dd HH:mm:ss)

Response

data

Name	Type	Description
search_total	Integer	검색된 목록 수
page	Integer	현재 페이지 번호
max_page	Integer	최대 페이지 번호
list	list[]	영상 목록

list

Name	Type	Description
uuid	String	영상 UUID (녹화 영상 다운로드에서 사용)
dev_id	String	디바이스ID
dev_label	String	디바이스 라벨
cate	String	미디어 구분(P:실시간/H:수동실시간/N:일반/S:SOS)
file_type	String	파일 종류(M:동영상/V:음성/I:이미지)
file_size	Integer	파일 용량(KB)
rec_dt	String	녹화일 (YYYY-MM-DD hh:mm:ss)

status

Name	Type	Description
code	Integer	HTTP 응답코드
status	Boolean	요청 성공 여부
message	String	요청 응답메시지

응답 예제

{
    "data": {
        "search_total": 3,
        "page": 1,
        "max_page": 1,
        "list": [
            {
                "uuid": "8939fcf1-0b53-46c8-90b9-135c40ce9bb2_20230404123749",
                "dev_id": "mx23jan0008",
                "dev_label": "mx23jan0008",
                "cate": "S",
                "file_type": "M",
                "file_size": 914,
                "rec_dt": "2023-04-04 12:37:49"
            },
            {
                "uuid": "203962fb-9eaa-40b1-b304-225b9a390197_20230404122720",
                "dev_id": "mx23jan0008",
                "dev_label": "mx23jan0008",
                "cate": "S",
                "file_type": "M",
                "file_size": 841,
                "rec_dt": "2023-04-04 12:27:20"
            },
            {
                "uuid": "59cd02f9-9f01-40a4-a564-b322ed2a8ce6_20230404122508",
                "dev_id": "mx23jan0008",
                "dev_label": "mx23jan0008",
                "cate": "N",
                "file_type": "M",
                "file_size": 145,
                "rec_dt": "2023-04-04 12:25:08"
            }
        ]
    },
    "status": {
        "code": 200,
        "success": true,
        "message": "success"
    }
}

녹화 영상 다운로드

POST /v1/record/download/link content_copy

녹화된 영상 다운로드 링크 생성

Header

Parameter

uuid영상 UUID / 필수

Response

data

Name	Type	Description
link	String	다운로드 링크

status

Name	Type	Description
code	Integer	HTTP 응답코드
status	Boolean	요청 성공 여부
message	String	요청 응답메시지

응답 예제

{
    "data": {
        "link": "https://api.spoot.kr/v1/record/download/file/c1ca130978cf6bb8c834170c1a36e053"
    },
    "status": {
        "code": 200,
        "success": true,
        "message": "success"
    }
}