태그 관리 (v1 전용)
태그 관리 기능 미지원 안내
- 지원 범위: 태그 생성/추가/제거/검색과 관련된 모든 엔드포인트는 v1에서만 제공되던 레거시 기능이며, v2 및 v3 스펙에서는 완전히 폐기되었습니다.
- 마이그레이션 권장 사항: v3로 전환 시 카테고리를 세분화하여 할당하는 방식 등 대체 비즈니스 로직으로의 시스템 개편을 권장합니다.
태그별 콘텐츠 목록 조회
- 기존 (v1):
GET/media/tag/search/{tag} - 변경 (v2/v3): 미지원
v1 응답 구조 특이 사항
v1의 응답 구조는 최신 API 표준과 다소 상이한 특이 케이스들을 포함하고 있습니다. 마이그레이션 전 레거시 시스템의 응답 파서 로직 분석 시 참고하기 바랍니다.
message필드 누락:{ "error", "result" }구조만 존재하며,message필드가 응답에 포함되지 않습니다.- 데이터 타입 불일치 (
count): 전체 결과 개수를 나타내는result.count값이 Integer가 아닌 문자열(예:"0") 타입으로 반환됩니다. - 배열 중첩 구조의 비일관성 (
items):- 조회 결과 데이터가 1건 이상 존재할 경우,
items.item하위의 배열 객체로 중첩되어 반환됩니다. ({"items": {"item": [...]}}) - 조회 결과가 0건일 경우,
items키 자체가 빈 배열 구조로 반환됩니다. ({"items": []})
- 조회 결과 데이터가 1건 이상 존재할 경우,
- 응답 필드 타입: 응답 데이터 중
original_file_size,status, 타임스탬프 데이터는 Integer 타입으로 반환되며,audio_channel은 Boolean 타입으로 반환됩니다. - 필드명 주의: 비디오 프레임 수 필드명은 언더스코어(
_)가 생략된video_framecount형태입니다.
태그 추가
- 기존 (v1):
POST/media/tag/attach - 변경 (v2/v3): 미지원
요청 본문 및 응답 구조 상세
태그 제거
- 기존 (v1):
POST/media/tag/detach - 변경 (v2/v3): 미지원