플레이어를 생성하는 방법은 다음과 같습니다.
요청
POST {API_URL}/players
요청 파라미터
| 필드명 |
필수 여부 |
타입 |
제약 사항 |
설명 |
| name |
Y |
String |
영문, 숫자, 최소 3자, 최대 30자. |
생성할 플레이어 이름
"플레이어 이름 검증" API 를 통해 검증할 수 있음 |
| version |
N |
String |
default 최신버젼 |
SDK 버젼 목록 조회 API 통해 확인 가능 |
| auto_update |
N |
String |
default "N" |
자동 업데이트 여부 (Y / N ) |
| domains |
Y |
Array |
|
도메인 목록 |
| domains.type |
Y |
string |
web / ios / aos |
3가지 중에 선택 |
| domains.domain |
Y |
string |
URL / 패키지 아이디 |
|
성공 코드
| HttpStatusCode |
Code |
Message |
| 200 |
200 |
ok |
에러 코드
| 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. |
무료인 경우 1개로 제한 |
| 200 |
4805 |
The player name already exists. |
|
요청 예시
POST /api/v1/player
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=
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/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."
}
}