Skip to main content

Registration and Management

Set or change the player's nickname.

URL Confirmation

This API uses the service-account.playnanoo.com domain.

API Information

  • URL: https://service-account.playnanoo.com/api/v20240401/nickname/put
  • Method: PUT
  • Authentication Required: Yes

Request Parameters

ParameterTypeRequiredDescription
change_nicknamestringRequiredNickname to set
check_existsstringRequiredCheck for duplicates ("Y": Check, "N": Don't check)
platformstringRequiredPlatform (e.g., "aos", "ios")
device_idstringRequiredDevice unique ID
device_modelstringRequiredDevice model name
device_osstringRequiredDevice OS
device_languagestringRequiredDevice language (e.g., "KO", "EN")

Response Data

Res Structure

FieldTypeDescription
NicknameFStringSet nickname

Code Example

void UMyGame::SetNickname(const FString& AccessToken, const FString& NewNickname, bool bCheckExists)
{
// Create request body with player information
TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
Body->SetStringField(TEXT("change_nickname"), NewNickname);
Body->SetStringField(TEXT("check_exists"), bCheckExists ? TEXT("Y") : TEXT("N"));

// Convert to JSON string
FString JsonBody = FPlayNANOOHelper::ToJsonString(Body);

// HTTP request
TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
Request->SetURL(TEXT("https://service-account.playnanoo.com/api/v20240401/nickname/put"));
Request->SetVerb(TEXT("PUT"));
FPlayNANOOHelper::SetCommonHeaders(Request, true); // Include authentication token
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))
{
FString Nickname;
JsonObject->TryGetStringField(TEXT("Nickname"), Nickname);
UE_LOG(LogTemp, Log, TEXT("Nickname set successfully: %s"), *Nickname);
}
}
});

Request->ProcessRequest();
}
check_exists Parameter

Setting it to "Y" prevents duplicate nicknames. Generally recommended to use "Y".