플레이어 목록 조회

Prev Next

플레이어 목록을 조회합니다.

요청

GET {API_URL}/players

요청 파라미터

필드명 필수 여부 타입 제약 사항 설명
page_size N Integer 10 ~ 1000 페이지당 항목 수 (default: 10)
page_no N Integer 1 ~ 1000 페이지 번호 (default: 1)
sort_type N String desc / asc 생성일 기준 정렬 (default: desc)

응답

필드명 타입 설명 비고
result [] Object
result.page_count Integer 전체 페이지 수
result.page_no Integer 현재 페이지 번호
result.page_size Integer 요청한 페이지 당 항목 수
result.total Integer 총 항목 수
result.pricing String 유저의 요금제 (free:무료 / pay:유료)
result.list [] Object
result.list.no Integer 플레이어 번호
result.list.name String 플레이어 이름
result.list.version String SDK 플레이어 버전
result.list.access_key String 플레이어 접근 키
result.list.updated_at String 수정일시
result.list.created_at String 생성일시

성공 코드

HttpStatusCode Code Message
200 200 ok

요청 예시

GET /api/v1/players
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=

응답 예시

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": [ {
        "no": 3994,
         "name": "apiguide",
         "version": "latest",
         "access_key": "23c6e1b8cd62a6b0f12db7920f7336f0",
         "updated_at": "2024-08-23T01:34:13.000+00:00",
         "created_at": "2024-08-23T01:34:13.000+00:00"
    } ],
    "pagination": {
        "page_size": 10,
        "page_no": 1,
        "total": 1,
        "page_count": 1
    },
    "pricing": "pay"
}