본문으로 건너뛰기

태그 관리 (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": []})
  • 응답 필드 타입: 응답 데이터 중 original_file_size, status, 타임스탬프 데이터는 Integer 타입으로 반환되며, audio_channel은 Boolean 타입으로 반환됩니다.
  • 필드명 주의: 비디오 프레임 수 필드명은 언더스코어(_)가 생략된 video_framecount 형태입니다.

태그 추가

  • 기존 (v1): POST /media/tag/attach
  • 변경 (v2/v3): 미지원
요청 본문 및 응답 구조 상세

요청 본문

필드데이터 타입필수 여부설명
tagString필수추가할 태그 문자열
upload_file_keyString필수태그 추가 대상 콘텐츠 식별자

응답 구조 명세

{
"error": 0,
"message": "success",
"result": {}
}

태그 제거

  • 기존 (v1): POST /media/tag/detach
  • 변경 (v2/v3): 미지원
요청 본문 및 응답 구조 상세

요청 본문

요청 본문 스펙은 태그 추가 API와 완전히 동일합니다.

필드데이터 타입필수 여부설명
tagString필수제거할 태그 문자열
upload_file_keyString필수태그 제거 대상 콘텐츠 식별자

응답 구조 명세

태그 추가 API와 동일하게 성공 시 빈 result 객체를 반환합니다.

{
"error": 0,
"message": "success",
"result": {}
}