Create Player
- Print
- PDF
Create Player
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
The following describes how to create a player.
Requests
POST {API_URL}/players
Request Parameters
| Field name | Requirement status | Type | Restrictions | Description |
|---|---|---|---|---|
| name | Y | String | English 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 |
| version | N | String | Latest default version | SDK version list can be viewed through API |
| auto_update | N | String | default "N" | Automatic updates (Y/N) |
| domains | Y | Array | Domain list | |
| domains.type | Y | string | web / ios / aos | Select from 3 |
| domains.domain | Y | string | URL / package ID |
Success code
| HttpStatusCode | Code | Message |
|---|---|---|
| 200 | 200 | ok |
Errors
| HttpStatusCode | Code | Message | Description |
|---|---|---|---|
| 200 | 4100 | No version information. | |
| 200 | 4700 | Body (JSON) name is missing. | |
| 200 | 4707 | Body (JSON) pricing is missing or invalid. | |
| 200 | 4702 | Body (JSON) domains is missing. | |
| 200 | 4703 | Some domains in Body (JSON) domains are invalid. (if type is web) | |
| 200 | 4705 | Some types in Body (JSON) domains are invalid. | |
| 200 | 4708 | There are duplicate domains in Body (JSON) domains. | |
| 200 | 4709 | Up to 5 domains can be added to Body (JSON) domains. | |
| 200 | 4711 | Only 1 Body (JSON) app per OS can be added. | |
| 200 | 4712 | At least 1 Body (JSON) web domain must be added. | |
| 200 | 4799 | Enter an option value for Body (JSON). | |
| 200 | 4800 | No player has been added. | |
| 200 | 4801 | No player information. | |
| 200 | 4802 | This player already exists. | |
| 200 | 4803 | The number of players exceeded the limit. | Limited to 1 when free |
| 200 | 4805 | The 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"
}
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."
}
}
Was this article helpful?