토큰 갱신
리프레시 토큰을 사용하여 새로운 액세스 토큰을 발급받습니다.
URL 확인
이 API는 service-account.playnanoo.com 도메인을 사용합니다.
API 정보
- URL:
https://service-account.playnanoo.com/api/v20240401/token/refresh - Method:
PUT - 인증 필요: 아니오
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| refresh_token | string | 필수 | 리프레시 토큰 |
| platform | string | 필수 | 플랫폼 (예: "aos", "ios") |
| device_id | string | 필수 | 기기 고유 ID |
| device_model | string | 필수 | 기기 모델명 |
| device_os | string | 필수 | 기기 OS |
| device_language | string | 필수 | 기기 언어 (예: "KO", "EN") |
응답 데이터
Res 클래스
| 필드 | 타입 | 설명 |
|---|---|---|
| Token | FSerializeTokenData | 토큰 정보 |
| Player | FSerializePlayerData | 플레이어 정보 |
FSerializeTokenData 구조
| 필드 | 타입 | 설명 |
|---|---|---|
| AccessToken | FString | 액세스 토큰 |
| RefreshToken | FString | 리프레시 토큰 |
FSerializePlayerData 구조
| 필드 | 타입 | 설명 |
|---|---|---|
| UserUniqueID | FString | 사용자 고유 ID |
| OpenID | FString | 오픈 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();
}
토큰 갱신 시기
액세스 토큰 만료 시 401 Unauthorized 응답을 받으면 리프레시 토큰으로 새 액세스 토큰을 발급받으세요.