본문으로 건너뛰기

중복 재생 차단 관리

중복 재생 차단 관리 API v3 레퍼런스 바로가기
신규 기능 안내
  • 지원 범위: 중복 재생 차단 관리 기능은 v3에 신규 추가된 기능으로, v1 및 v2에서는 지원하지 않습니다.
  • 공통 경로 파라미터: 모든 엔드포인트는 URL 경로(Path)에 대상 서비스 계정의 고유 식별자인 {service_account_key}를 필수로 요구합니다.
  • 공통 인증: 모든 API는 쿼리 스트링 파라미터(?access_token=)를 이용한 공통 인증 방식을 사용합니다.

중복 재생 차단 기록 조회​

  • 지원 버전 (v3): GET /service-accounts/{service_account_key}/duplicate-blocks/logs
요청 파라미터 및 응답 구조 상세

요청 쿼리 파라미터​

파라미터데이터 타입필수 여부설명
client_user_idString선택고객사 사용자 ID
player_idString선택플레이어(기기) ID
start_dateString선택조회 범위 시작 일시
end_dateString선택조회 범위 종료 일시
pageInteger선택조회 대상 페이지 번호
per_pageInteger선택페이지당 출력 데이터 개수

응답 구조 명세​

{
  "data": [
    {
      "id": 1,
      "media_content_title": "title_string",
      "upload_file_key": "upload_file_key_string",
      "player_id": "player_id_string",
      "key": "key_string",
      "client_user_id": "user_01",
      "hardware_id": "hw_id_string",
      "created_at": "2023-10-01T10:00:00Z"
    }
  ],
  "pagination": {
    "total_count": 1,
    "page": 1,
    "per_page": 10
  }
}

중복 재생 허용 기기 조회​

  • 지원 버전 (v3): GET /service-accounts/{service_account_key}/duplicate-blocks/players
요청 파라미터 및 응답 구조 상세

요청 쿼리 파라미터​

파라미터데이터 타입필수 여부설명
client_user_idString필수고객사 사용자 ID

응답 구조 명세​

{
  "data": {
    "total_count": 2,
    "player_id": [
      "player_id_01",
      "player_id_02"
    ]
  }
}

중복 재생 허용 기기 삭제​

  • 지원 버전 (v3): DELETE /service-accounts/{service_account_key}/duplicate-blocks/players
요청 파라미터 및 응답 구조 상세

요청 쿼리 파라미터​

파라미터데이터 타입필수 여부설명
client_user_idString필수고객사 사용자 ID
player_idString필수플레이어(기기) ID

응답 구조 명세​

{
  "data": [],
  "status": "ok"
}

중복 재생 허용 기기 전체 초기화​

  • 지원 버전 (v3): POST /service-accounts/{service_account_key}/duplicate-blocks/players/reset
요청 본문 및 응답 구조 상세

요청 본문​

필드데이터 타입필수 여부설명
client_user_idString필수고객사 사용자 ID

응답 구조 명세​

{
  "data": [],
  "status": "ok"
}