플레이어 조회

Prev Next

플레이어의 상세 정보를 조회하는 방법은 다음과 같습니다.

요청

GET {API_URL}/players/{player_no}

요청 파라미터

필드명 필수 여부 타입 제약 사항 설명
player_no Y Integer Path Parameter 플레이어 번호

응답

필드명 타입 설명
result Object
result.no Integer 플레이어 번호
result.name String 플레이어 이름
result.version String 선택한 플레이어 SDK 버전
result.auto_update String 자동 업데이트 여부
result.access_key String 플레이어 액세스 키
result.updated_at String 수정일시
result.created_at String 생성일시
result.domains Object 등록된 도메인 정보
result.domains.ios Object 등록된 ios 앱 데이터
result.domains.ios.no Integer 도메인 pk
result.domains.ios.type String 도메인 타입
result.domains.ios.domain String aos 패키지 아이디
result.domains.ios.created_at String 도메인 등록일시
result.domains.aos Object 등록된 aos 앱 데이터
result.domains.aos.no Integer 도메인 pk
result.domains.aos.type String 도메인 타입
result.domains.aos.domain String aos 패키지 아이디
result.domains.aos.created_at String 도메인 등록일시
result.domains.web Object 등록된 도메인 중 web
result.domains.web.no Integer 도메인 pk
result.domains.web.type String 도메인 타입
result.domains.web.domain String URL
result.domains.web.created_at String 도메인 등록일시

요청 예시

GET /api/v1/player/1
HOST: vpe.apigw.gov-ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=

성공 코드

HttpStatusCode Code Message
200 200 ok

에러 코드

HttpStatusCode Code Message Description
200 4601 Query string player_no is missing.
200 4801 No player information.

응답 예시

HTTP/1.1 200 OK
Date: Fri, 26 Feb 2021 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
  "code": "200",
  "message": ok,
  "result": {
    "name": "test",
    "no": 1234,
    "version" : "1.0.0",
    "auto_update": "Y",
    "domains": {
      "aos": [
        {
          "no": 6965,
          "type": "aos",
          "domain": "com.test.com",
          "created_at": "2023-04-13T01:34:13.000+00:00"
        }
      ],
      "ios": [
        {
          "no": 6964,
          "type": "ios",
          "domain": "com.test.com",
          "created_at": "2023-04-13T01:34:13.000+00:00"
        }
      ],
      "web": [
        {
          "no": 6963,
          "type": "web",
          "domain": "http://test.com",
          "created_at": "2023-04-13T01:34:13.000+00:00"
        }
      ]
    },
    "access_key": "92f4a22e68",
    "created_at": "2023-04-13T01:34:13.000+00:00",
    "updated_at": "2023-04-19T03:19:06.000+00:00"
  }
}