토큰 삭제

서버에 등록된 사용자 푸시 토큰을 삭제합니다.

URL 확인

이 API는 service-api.playnanoo.com 도메인을 사용합니다.

API 정보

• URL: https://service-api.playnanoo.com/push/v20220701/remove
• Method: PUT
• 인증 필요: 예

DeviceInfo 상속

이 API의 Req 클래스는 DeviceInfo를 상속받습니다. DeviceInfo의 모든 속성이 자동으로 포함됩니다.

요청 파라미터

이 API는 추가 요청 파라미터가 없습니다.

응답 데이터

Res 클래스

필드	타입	설명
Status	string	처리 결과 상태

Unity C# 구현

BaseResponse 클래스

모든 API 응답의 기본 클래스입니다.

public class BaseResponse
{
    public string ErrorCode;
    public string Message;
    public string WithdrawalKey;
    public string BlockKey;
}

필드 설명:

• ErrorCode: 에러 코드
• Message: 에러 메시지
• WithdrawalKey: 탈퇴 유예 상태인 경우 복구에 필요한 키 (탈퇴 유예 중인 계정만 제공)
• BlockKey: 차단된 계정인 경우 제공되는 키 (차단된 계정만 제공)

푸시 토큰 삭제 클래스

using System;
using System.Collections;
using UnityEngine.Networking;

public class PushRemove
{
    static string url = "https://service-api.playnanoo.com/push/v20220701/remove";

    [Serializable]
    public class Req : DeviceInfo
    {
        public IEnumerator Send(
            Action<Res> onSuccess,
            Action<BaseResponse> onError)
        {
            // PUT 방식 호출
            yield return HttpClient.Send<Req, Res>(
                UnityWebRequest.kHttpVerbPUT,
                url,
                requireToken: true,
                body: this,
                onSuccess: onSuccess,
                onError: onError
            );
        }
    }

    [Serializable]
    public class Res : BaseResponse
    {
        public string Status;
    }
}

사용 예제

using PlayNANOO;

public class PlayNANOOExample : MonoBehaviour
{
    void Start()
    {
        RemovePushToken();
    }

    void RemovePushToken()
    {
        PushRemove.Req req = new PushRemove.Req();

        StartCoroutine(req.Send(
            onSuccess: res =>
            {
                Debug.Log($"푸시 토큰 삭제 성공: {res.Status}");
            },
            onError: (error) =>
            {
                Debug.LogError($"푸시 토큰 삭제 실패: [{error.ErrorCode}] [{error.Message}]");
            }
        ));
    }
}

토큰 삭제 시점

사용자가 로그아웃하거나 푸시 알림을 완전히 비활성화할 때 이 API를 호출하여 서버에서 푸시 토큰을 제거할 수 있습니다.

재등록 필요

토큰을 삭제한 후 다시 푸시 알림을 받으려면 토큰 저장 API를 통해 재등록해야 합니다.

사용 사례

• 사용자 로그아웃 시
• 앱 삭제 전 정리 작업
• 푸시 알림 완전 비활성화 시