외부 연동 규격
개요
영상 그룹
영상 그룹은 영상(video)을 묶는 단위다. 드라마 한 시리즈, 야구 한 경기가 그룹 1건이고, 그 아래에 영상이 회차(order_no )로 달린다. 카테고리(cate_id )와 완료 콜백(callback_url )은 영상이 아니라 그룹의 속성이다.
예) 김부장 (1~10편) 이 있다면 “김부장” 이 영상 그룹이고 “김부장-1편”, ”김부장-2편” 은 영상으로 들어간다.
POST | http://<host>:<port>/api/v1/video_group | 그룹 등록. v_g_id 를 발급해 돌려준다 |
|---|---|---|
PUT | http://<host>:<port>/api/v1/video_group | 그룹 수정. 전체 교체 방식 |
영상 그룹 생성
Request
- 예제
POST http://{HOST}:{PORT}/api/v1/video_group
Content-Type: application/json
{
"cate_id": 5100,
"name": "2026 KBO 정규시즌",
"callback_url": "http://sbs.co.kr/",
"comment": "정규시즌"
}
- 설명
| 필드 | 필수 | 타입 | 크기 | 설명 |
|---|---|---|---|---|
| cate_id | 필수 | int | - | 카테고리 ID |
| name | 필수 | str | 1~100 | 그룹 이름 |
| callback_url | 선택 | str | 200 | 그룹 전체 공정이 끝났을 때 통보받을 URL |
| comment | 선택 | str | 200 | 비고 |
Response
{"code": 0, "result": "OK", "v_g_id": 12}
영상 그룹 수정
Request
- 예제
PUT http://{HOST}:{PORT}/api/v1/video_group
Content-Type: application/json
{
"v_g_id": 12,
"cate_id": 5100,
"name": "2026 KBO KT vs NC",
"callback_url": "http://sbs.co.kr/",
"comment": "정규시즌"
}
- 설명
| 필드 | 필수 | 타입 | 크기 | 설명 |
|---|---|---|---|---|
| v_g_id | 필수 | int | - | 수정할 그룹 ID |
| cate_id | 선택 | int | - | 카테고리 ID |
| name | 선택 | str | 1~100 | 그룹 이름 |
| callback_url | 선택 | str | 200 | 그룹 전체 공정이 끝났을 때 통보받을 URL |
| comment | 선택 | str | 200 | 비고 |
Response
{"code": 0, "result": "OK", "v_g_id": 12}
영상 타이틀 생성
영상(video)은 분석 단위다. 드라마 한 회차, 야구 한 경기가 영상 1건이고, 영상 그룹(v_g_id ) 아래에 회차(order_no )로 달린다. 이름·방송 연도·스트림 여부(stream_yn )는 영상의 속성이고, 카테고리와 콜백은 그룹의 것을 따른다. 실제 영상 파일은 STT 요청(stt_svc ) 때 이 v_id 에 붙는다.
예) 예) "김부장" 그룹에 "김부장-1편"(order_no 1), "김부장-2편"(order_no 2) 이 영상으로 들어간다. 야구는 경기 1건이 그룹이고 영상도 1건이다.
| POST | http:// | 영상 등록. v_id 를 발급해 돌려준다 |
|---|---|---|
| PUT | http:// | 영상 수정. 전체 교체 방식 |
영상 타이틀 생성
Request
- 예제
POST http://{HOST}:{PORT}/api/v1/video
Content-Type: application/json
{
"v_g_id": 12,
"name": "2026 KBO KT vs NC",
"order_no": 1,
"play_year": 2026,
"stream_yn": "N",
"comment": "8월 31일 경기"
}
- 설명
| 필드 | 필수 | 타입 | 크기 | 설명 |
|---|---|---|---|---|
| v_g_id | 필수 | int | - | 소속 그룹 ID |
| name | 필수 | str | 1~50 | 영상 이름 |
| order_no | 선택 | int | - | 그룹 안 회차. 없으면 마지막 회차 + 1 |
| play_year | 선택 | int | - | 방송 연도 |
| stream_yn | 선택 | str | 1 | 스트림(조각) 영상이면 Y, VOD 전체면 N. 기본 N |
| comment | 선택 | str | 200 | 비고 |
Response
{"code": 0, "result": "OK", "v_id": 1012}
영상 타이틀 수정
Request
- 예제
PUT http://{HOST}:{PORT}/api/v1/video
Content-Type: application/json
{
"v_id": 1012,
"v_g_id": 12,
"name": "2026 KBO KT vs NC",
"order_no": 1,
"play_year": 2026,
"stream_yn": "N",
"comment": "8월 31일 경기"
}
- 설명
| 필드 | 필수 | 타입 | 크기 | 설명 |
|---|---|---|---|---|
| v_id | 필수 | int | - | 수정할 영상 ID |
| v_g_id | 필수 | int | - | 소속 그룹 ID |
| name | 필수 | str | 1~50 | 영상 이름 |
| order_no | 필수 | int | - | 그룹 안 회차 |
| play_year | 선택 | int | - | 방송 연도 |
| stream_yn | 선택 | str | 1 | 스트림(조각) 영상이면 Y, VOD 전체면 N. 기본 N |
| comment | 선택 | str | 200 | 비고 |
Response
{"code": 0, "result": "OK", "v_id": 12}