跳转到主要内容

查询注销账号信息

使用注销密钥查询注销信息的API。

URL确认

此API使用 service-account.playnanoo.com 域名。

API信息

  • URL: https://service-account.playnanoo.com/api/v20240101/withdrawal/search
  • Method: PUT
  • 需要认证: 否

请求参数

参数类型必填说明
withdrawal_keystring必填注销Key
platformstring必填平台 (例如: "aos", "ios")
device_idstring必填设备唯一ID
device_modelstring必填设备型号
device_osstring必填设备OS
device_languagestring必填设备语言 (例如: "KO", "EN")

响应数据

Res结构体

字段类型说明
StatusFString注销状态
MemoFString注销原因备注
WithdrawalDateFString预计注销日期

Unreal C++实现

头文件 (WithDrawalSearch.h)

// WithDrawalSearch.h
#pragma once

#include "CoreMinimal.h"
#include "Json.h"
#include "JsonUtilities.h"

// 응답 콜백 델리게이트
DECLARE_DELEGATE_OneParam(FOnWithDrawalSearchSuccess, const FString&);
DECLARE_DELEGATE_OneParam(FOnWithDrawalSearchError, const FString&);

class YOURPROJECT_API FWithDrawalSearch
{
public:
// 요청 구조체 (디바이스 정보는 FPlayNANOOHelper::CreateRequestBody()에서 자동 생성)
struct FReq
{
FString withdrawal_key;
};

// 응답 구조체
struct FRes
{
FString ErrorCode;
FString Message;
FString Status;
FString Memo;
FString WithdrawalDate;

bool FromJson(const FString& JsonString)
{
TSharedPtr<FJsonObject> JsonObject;
TSharedRef<TJsonReader<>> Reader = TJsonReaderFactory<>::Create(JsonString);

if (FJsonSerializer::Deserialize(Reader, JsonObject) && JsonObject.IsValid())
{
JsonObject->TryGetStringField(TEXT("ErrorCode"), ErrorCode);
JsonObject->TryGetStringField(TEXT("Message"), Message);
JsonObject->TryGetStringField(TEXT("Status"), Status);
JsonObject->TryGetStringField(TEXT("Memo"), Memo);
JsonObject->TryGetStringField(TEXT("WithdrawalDate"), WithdrawalDate);
return true;
}
return false;
}
};

/**
* 탈퇴 정보 조회 요청 전송
*/
static void Send(
const FString& WithdrawalKey,
FOnWithDrawalSearchSuccess OnSuccess,
FOnWithDrawalSearchError OnError
);
};

实现文件 (WithDrawalSearch.cpp)

// WithDrawalSearch.cpp
#include "WithDrawalSearch.h"
#include "PlayNANOOHelper.h"
#include "Http.h"

void FWithDrawalSearch::Send(
const FString& WithdrawalKey,
FOnWithDrawalSearchSuccess OnSuccess,
FOnWithDrawalSearchError OnError)
{
// 요청 데이터 생성 (디바이스 정보는 자동 포함)
TSharedPtr<FJsonObject> JsonObject = FPlayNANOOHelper::CreateRequestBody();

// API 전용 파라미터 추가
JsonObject->SetStringField(TEXT("withdrawal_key"), WithdrawalKey);

// JSON 변환
FString JsonBody;
TSharedRef<TJsonWriter<>> Writer = TJsonWriterFactory<>::Create(&JsonBody);
FJsonSerializer::Serialize(JsonObject.ToSharedRef(), Writer);

// HTTP 요청 생성
TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
Request->SetURL(TEXT("https://service-account.playnanoo.com/api/v20240101/withdrawal/search"));
Request->SetVerb(TEXT("PUT"));
FPlayNANOOHelper::SetCommonHeaders(Request, false); // 인증 토큰 불필요
Request->SetContentAsString(JsonBody);

// 응답 처리
Request->OnProcessRequestComplete().BindLambda(
[OnSuccess, OnError](FHttpRequestPtr Req, FHttpResponsePtr Res, bool bSuccess)
{
if (bSuccess && Res.IsValid())
{
FString Response = Res->GetContentAsString();
FRes Result;
if (Result.FromJson(Response))
{
if (Result.ErrorCode.IsEmpty())
{
OnSuccess.ExecuteIfBound(Response);
}
else
{
OnError.ExecuteIfBound(Response);
}
}
else
{
OnError.ExecuteIfBound(TEXT("Failed to parse response"));
}
}
else
{
FString ErrorMsg = Res.IsValid() ? Res->GetContentAsString() : TEXT("Request failed");
OnError.ExecuteIfBound(ErrorMsg);
}
});

Request->ProcessRequest();
}

使用示例

void UYourClass::SearchWithdrawalInfo(const FString& WithdrawalKey)
{
FWithDrawalSearch::Send(
WithdrawalKey,
FOnWithDrawalSearchSuccess::CreateLambda([](const FString& Response)
{
FWithDrawalSearch::FRes Result;
if (Result.FromJson(Response))
{
UE_LOG(LogTemp, Log, TEXT("탈퇴 상태: %s"), *Result.Status);
UE_LOG(LogTemp, Log, TEXT("탈퇴 사유: %s"), *Result.Memo);
UE_LOG(LogTemp, Log, TEXT("탈퇴 예정일: %s"), *Result.WithdrawalDate);

// 날짜 파싱 예제
FDateTime WithdrawalDate;
if (FDateTime::ParseIso8601(*Result.WithdrawalDate, WithdrawalDate))
{
FTimespan Remaining = WithdrawalDate - FDateTime::Now();
UE_LOG(LogTemp, Log, TEXT("남은 기간: %d일 %d시간"),
Remaining.GetDays(), Remaining.GetHours());
}
}
}),
FOnWithDrawalSearchError::CreateLambda([](const FString& Error)
{
UE_LOG(LogTemp, Error, TEXT("탈퇴 정보 조회 실패: %s"), *Error);
})
);
}
确认预计注销日期

通过WithdrawalDate字段可以确认账号被完全删除的日期。在该日期之前调用恢复API即可恢复账号。