게임 이용 제한 유저 확인하기
어떤 유저가 커뮤니티, 게임 웹페이지 등에서 웹 로그인으로 로그인 시도 시 게임에서 이용이 제한된 유저인지 알려줍니다.
Basics
| 설명 | |
|---|---|
| Request URL |
|
| Method | POST |
| HTTP Header | Content-type: application/json |
| Response Format | JSON |
Request
| 명칭 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| appid | String | O | 앱 아이디 |
| player_id | Integer | O | 플레이어 아이디 |
| language | String | X |
언어값입니다. 입력하지 않으면 영어로 설정됩니다.
|
Response
| 명칭 | 타입 | 설명 | 비고 |
|---|---|---|---|
| code | Integer | 결과 코드 |
* 유효하지 않음: 값이 없거나, null 값. 유효하지 않은 게임, 회사 결과 코드를 받으면 Hive 콘솔 앱센터에서 게임과 회사를 다시 설정해야 함. |
| data | Object | 결과 데이터 | |
| data.is_blocked | Boolean | 이용 제한 여부 |
|
| data.status | String | 이용 제한 상태 |
|
| data.start_date | String | 이용 제한 시작일 | |
| data.end_data | String | 이용 제한 종료일 | |
| data.remaining_date | String | 이용 제한 남은 일수 | language 해당 언어로 표기(기본값: 영어) |
| data.reason | String | 이용 제한 사유 | language 해당 언어로 표기(기본값: 영어) |
Request Examples
|
1 2 3 |
curl -X POST https://weblogin.withhive.com/block_info -H 'Content-Type: application/json' -d '{"appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common", "player_id": 20000020208, "language": "ko"}' |
Response Examples
성공 (정상 유저)
|
1 2 3 4 5 6 7 8 9 10 11 |
{ "code": 100, "data": { "is_blocked": false, "status": "N", "start_date": null, "end_date": null, "remaining_date": null, "reason": null } } |
성공 (이용 제한 기간이 있는 이용 제한 유저)
|
1 2 3 4 5 6 7 8 9 10 11 |
{ "code": 100, "data": { "is_blocked": true, "status": "B", "start_date": "2023-07-12 14:42:17", "end_date": "2023-10-10 14:42:17", "remaining_date": "90 day(s)", "reason": "Temporary Restriction (Retrieve game money)" } } |
성공 (영구 이용 제한 유저)
|
1 2 3 4 5 6 7 8 9 10 11 |
{ "code": 100, "data": { "is_blocked": true, "status": "P", "start_date": "2023-07-12 14:42:17", "end_date": "9999-12-31 00:00:00", "remaining_date": "Permanent", "reason": "Temporary Restriction (Retrieve game money)" } } |
실패
|
1 2 3 4 |
{ "code": 2002, "data": {} } |