MENU
      Create Player

        Create Player


        Article summary

        The following describes how to create a player.

        Requests

        POST {API_URL}/players
        HTTP

        Request Parameters

        Field nameRequirement statusTypeRestrictionsDescription
        nameYStringEnglish letters and numbers only. Must be between 3 and 30 characters in length.Player’s name to create
        Enable to verify it through the "Verify Player Name" API
        versionNStringLatest default versionSDK version list can be viewed through API
        auto_updateNStringdefault "N"Automatic updates (Y/N)
        domainsYArrayDomain list
        domains.typeYstringweb / ios / aosSelect from 3
        domains.domainYstringURL / package ID

        Success code

        HttpStatusCodeCodeMessage
        200200ok

        Errors

        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.Limited to 1 when free
        2004805The player name already exists.

        Request Examples

        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

        Response examples

        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
        
        // Upon success
        {
          "code": "200",
          "message": "ok"
        }
        
        // Upon failure
        "error": {
            "errorCode": "4802",
            "message": "This player already exists."
          }
        }
        HTTP

        Was this article helpful?

        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.