Hive 멤버십 탈퇴 여부 조회하기

게임 서버에서는 UID 또는 UID 목록을 이용해 HIVE 멤버십 유저의 탈퇴 여부를 조회할 수 있습니다. Request에 탈퇴 유저 여부를 조회할 UID나 UID 목록을 전달하면 Response에 탈퇴 유저의 UID와 탈퇴 완료 상태 값(status)인 D가 반환됩니다.

Request 시 한 번에 조회할 수 있는 UID는 최대 100개입니다. 조회 요청한 UID가 탈퇴 유저의 UID가 아니면 Response UID 목록에 UID와 상태 값(status)을 반환하지 않습니다. 조회 요청한 UID나 UID 목록에 탈퇴 회원이 없으면 에러코드 2100을 띄웁니다.

  • Request URL
상용 URL https://api.qpyou.cn/gameserver/user/status
테스트 URL https://test-api.qpyou.cn/gameserver/user/status
HTTP Method POST
Content-Type text/html
Data Format JSON
  • Request Body
필드명 설명 타입 필수여부
UID 탈퇴 유저 여부를 조회하는 UID String 또는 List Y
  • Request Sample
{
    "uid" : 10000
} 
or 
{
    "uid" : [10000, 10001, 10002, 10003]
}
  • Response Body
필드명 설명 타입
type API 타입 String
error_code 에러 코드
  • 0: 성공
  • 0 이외: 에러
Integer 0, 1201
error_msg 에러 코드가 0이 아닐 때 띄우는 에러 메시지 String
user_list 유저 UID 목록 List
user_list.Uid 탈퇴 유저의 UID String 10001
user_list.Status 탈퇴 유저의 탈퇴 완료 상태 값 String D
  • Response Sample
{ "type": "status",
    "error_code": 0,
    "user_list": [
        {
            "Uid": "10000",
            "Status": "D"
        },
        {
            "Uid": "10001",
            "Status": "D"
        }
    ]
}
or 
{ "type": "status",
    "error_code": 1201,
    "error_msg":  "Request has invalid format."
}
  • Error code
코드값 설명 메시지
0 성공
1201 Request 데이터 형식 오류 Request has invalid format.
2100 (탈퇴 회원 수가 0일 경우) 탈퇴 회원 없음 no data