刷新Token

使用刷新Token获取新的访问Token。

URL确认

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

API信息

• URL: https://service-account.playnanoo.com/api/v20240401/token/refresh
• Method: PUT
• 需要认证: 否

请求参数

参数	类型	必填	说明
refresh_token	string	必填	刷新Token
platform	string	必填	平台 (例如: "aos", "ios")
device_id	string	必填	设备唯一ID
device_model	string	必填	设备型号
device_os	string	必填	设备OS
device_language	string	必填	设备语言 (例如: "KO", "EN")

响应数据

Res类

字段	类型	说明
Token	FSerializeTokenData	Token信息
Player	FSerializePlayerData	玩家信息

FSerializeTokenData 结构

字段	类型	说明
AccessToken	FString	访问Token
RefreshToken	FString	刷新Token

FSerializePlayerData 结构

字段	类型	说明
UserUniqueID	FString	用户唯一ID
OpenID	FString	Open ID
Nickname	FString	昵称
LinkedID	FString	关联ID
LinkedType	FString	关联类型
PurchaseCount	int32	购买次数
PurchaseCurrencyCode	FString	购买货币代码
PurchaseTotalPrice	double	总购买金额
PurchaseVoidedCount	int32	退款次数
PurchaseVoidedCurrencyCode	FString	退款货币代码
PurchaseVoidedTotalPrice	double	总退款金额
Country	FString	国家
Timezone	FString	时区
Offset	int32	时间偏移
JoinPeriod	int32	注册时长

代码示例

void UMyGame::RefreshToken(const FString& RefreshToken)
{
    // 플레이어 정보가 포함된 요청 바디 생성
    TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
    Body->SetStringField(TEXT("refresh_token"), RefreshToken);

    // JSON 문자열 변환
    FString JsonBody = FPlayNANOOHelper::ToJsonString(Body);

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

    Request->OnProcessRequestComplete().BindLambda(
        [](FHttpRequestPtr Req, FHttpResponsePtr Res, bool bSuccess)
    {
        if (bSuccess && Res.IsValid())
        {
            TSharedPtr<FJsonObject> JsonObject;
            TSharedRef<TJsonReader<>> Reader = TJsonReaderFactory<>::Create(Res->GetContentAsString());

            if (FJsonSerializer::Deserialize(Reader, JsonObject))
            {
                // 토큰 정보
                const TSharedPtr<FJsonObject>* TokenObject;
                if (JsonObject->TryGetObjectField(TEXT("Token"), TokenObject))
                {
                    FString NewAccessToken;
                    (*TokenObject)->TryGetStringField(TEXT("AccessToken"), NewAccessToken);
                    UE_LOG(LogTemp, Log, TEXT("토큰 갱신 성공"));
                }

                // 플레이어 정보
                const TSharedPtr<FJsonObject>* PlayerObject;
                if (JsonObject->TryGetObjectField(TEXT("Player"), PlayerObject))
                {
                    FString Nickname;
                    (*PlayerObject)->TryGetStringField(TEXT("Nickname"), Nickname);
                    UE_LOG(LogTemp, Log, TEXT("Nickname: %s"), *Nickname);
                }
            }
        }
    });

    Request->ProcessRequest();
}

Token刷新时机

访问Token过期收到401 Unauthorized响应时，请使用刷新Token获取新的访问Token。