본문으로 건너뛰기

플레이어 관리

플레이어 관리 API v3 레퍼런스 바로가기
신규 기능 안내
  • 지원 범위: 플레이어 관리 기능은 v3에 신규 추가된 기능으로, v1 및 v2에서는 지원하지 않습니다.
  • 기능 분리 안내: 플레이어 스킨을 특정 채널에 연결/해제하는 기능은 채널 관리의 채널-플레이어 스킨 연결 및 채널-플레이어 스킨 연결 해제를 통해 수행해야 합니다.
  • 공통 인증: 모든 API는 쿼리 스트링 파라미터(?access_token=)를 이용한 공통 인증 방식을 사용합니다.

플레이어 스킨 목록 조회​

  • 지원 버전 (v3): GET /player-skins
응답 구조 상세

응답 구조 명세​

{
  "data": [
    {
      "id": 1,
      "title": "skin_01",
      "value": { ... },
      "channels": [
        {
          "key": "channel_key_string",
          "name": "channel_name_string",
          "status": true
        }
      ]
    }
  ]
}

플레이어 스킨 삭제​

  • 지원 버전 (v3): DELETE /player-skins/{player_skin_id}
요청 파라미터 및 응답 구조 상세

요청 경로 파라미터​

파라미터데이터 타입필수 여부설명
player_skin_idInteger필수삭제 대상 플레이어 스킨 ID

응답 구조 명세​

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

플레이어 이벤트 목록 조회​

  • 지원 버전 (v3): GET /player-events
용어 안내

'이벤트(Event)'는 광고 이벤트를 의미합니다. 즉, 이 엔드포인트는 전체 플레이어에 등록된 광고 이벤트 메타데이터 목록을 반환합니다.

응답 구조 상세

응답 구조 명세​

{
  "data": [
    {
      "id": 1,
      "title": "event_01",
      "value": { ... },
      "channels": [
        {
          "key": "channel_key_string",
          "name": "channel_name_string",
          "status": true
        }
      ]
    }
  ]
}

플레이어 이벤트 삭제​

  • 지원 버전 (v3): DELETE /player-events/{player_event_id}
요청 파라미터 및 응답 구조 상세

요청 경로 파라미터​

파라미터데이터 타입필수 여부설명
player_event_idInteger필수삭제 대상 플레이어 이벤트 ID

응답 구조 명세​

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