Hub/docs/methods/CS hubUserDelete

 CS_hubUserDelete

Description

주의! 기존에 게스트 계정 탈퇴 서버 API를 호출하여 구현된 탈퇴 기능과 동일한 기능입니다. (하단 Note에 내용 확인)
다만, 개별모듈 클라이언트에서도 계정 탈퇴를 진행할 수 있게 제공된 API라서 게임 프로젝트에서는 두 방식 중 선택하여 구현 바랍니다.
  • 게스트 유저 및 정식 유저의 계정 삭세를 요청하는 API
  • 계정 삭제가 성공하면 모듈 내부에서 로그아웃 처리를 진행하므로 별도의 로그아웃 API를 요청할 필요가 없음
  • 해당 API 호출 시 errorCode=0으로 성공할 경우 삭제된 계정의 uid가 반환됩니다.


Format

int CS_hubUserDelete(
    HubCallbackWithJSON closeCallback,
    void *callbackParam
);


Parameters

  • 별도의 파라메터 입력 없음


Return Value

  • HUB_E_NOTSUP
    • Hub 모듈이 초기화되지 않음.

 

  • HUB_E_INVALID
    • requestName으로 NULL 또는 빈 문자열이 전달됨.

 

  • HUB_E_INVALID_JSON
    • params으로 전달된 문자열이 JSON 형식에 맞지 않은 경우.

 

  • HUB_E_SUCCESS
    • API 호출 성공.


Note

  • API 호출 이 성공하면 현재 로그인 되어있던 게스트 혹은 Hive 정식 유저 계정이 탈퇴됩니다. 이후 게임앱에서는 타이틀 화면 등으로 이동한 뒤 유저에게 신규 게스트 및 Hive 정식 유저 로그인을 진행할 수 있게 게임의 로그인 버튼을 노출하도록 합니다.
  • 탈퇴 후 게임 진행에 대한 플로우는 아래 링크 API 레퍼런스 페이지의 하단(Hive 계정 삭제)에 있는 내용을 참고 바랍니다.
    • https://developers.withhive.com/c2s/api/


JSON

  • 탈퇴 성공 시
Key Data Type Value
"type" string "user/delete"
"error_code" number 0
"error_msg" string success

"uid"

string

계정 탈퇴된 사용자의 User Id (성공한 경우에만 반환됨)
로그인 성공 시,
{
    "type":"user/delete",
    "error_code":0,
    "uid":"27881360",
    "error_msg":"success",
}
  • 탈퇴 실패 시,
Key Data Type Value
"type" string "user/delete"
"error_code" number

2101 : 통신 실패

5020 : DB 에러

5301 : Request 데이터 형식 에러

5510 : Uid 정보 없음

5530 : 유효하지 않는 AppId

5570 : GuestUid 정보 없음

5630 : peppmerint 인증 실패

6005 : Guest 정보 불일치 (did , gameindex)
"error_msg" string error_code에 따른 메시지
탈퇴 실패 시,
{
    "type": "user/delete",
    "error_code": 5301
    "error_msg": "Request has invalid format",
}