MENU
      플레이어 생성

        플레이어 생성


        기사 요약

        플레이어를 생성하는 방법은 다음과 같습니다.

        요청

        POST {API_URL}/players
        HTTP

        요청 파라미터

        필드명필수 여부타입제약 사항설명
        nameYString영문, 숫자, 최소 3자, 최대 30자.생성할 플레이어 이름
        "플레이어 이름 검증" API 를 통해 검증할 수 있음
        versionNStringdefault 최신버젼SDK 버젼 목록 조회 API 통해 확인 가능
        auto_updateNStringdefault "N"자동 업데이트 여부 (Y / N )
        domainsYArray도메인 목록
        domains.typeYstringweb / ios / aos3가지 중에 선택
        domains.domainYstringURL / 패키지 아이디

        성공 코드

        HttpStatusCodeCodeMessage
        200200ok

        에러 코드

        HttpStatusCodeCodeMessageDescription
        2004100No version information.
        2004700Body (JSON) name is missing.
        2004707Body (JSON) pricing is missing or invalid.
        2004702Body (JSON) domains is missing.
        2004703Some domains in Body (JSON) domains are invalid. (if type is web)
        2004705Some types in Body (JSON) domains are invalid.
        2004708There are duplicate domains in Body (JSON) domains.
        2004709Up to 5 domains can be added to Body (JSON) domains.
        2004711Only 1 Body (JSON) app per OS can be added.
        2004712At least 1 Body (JSON) web domain must be added.
        2004799Enter an option value for Body (JSON).
        2004800No player has been added.
        2004801No player information.
        2004802This player already exists.
        2004803The number of players exceeded the limit.무료인 경우 1개로 제한
        2004805The player name already exists.

        요청 예시

        POST /api/v1/player
        HOST: vpe.apigw.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=
        x-ncp-region_code:KR
        
        Request body
        {
            "domains": [
                {
                    "domain": "http://test.com",
                    "type": "web"
                },
                {
                    "domain": "com.test.com",
                    "type": "ios"
                },
                {
                    "domain": "abcdefg",
                    "type": "aos"
                }
            ],
            "name": "testplayer1",
            "version" "1.0.0",
            "auto_update" : "N"
        }
        HTTP

        응답 예시

        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"
        }
        
        // 실패 시
        "error": {
            "errorCode": "4802",
            "message": "This player already exists."
          }
        }
        HTTP

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.