본문으로 건너뛰기

통신사 (telecom)

Thumbnail Image

🚀 추가된 버전 : SDKSDKv1.11.1
🔔 최신화 일자: 2026-07-24

개요​

telecom 네임스페이스는 통신사 관련 사용자 토큰을 네이티브 레이어에서 관리하는 기능을 제공합니다.

  • 사용자 토큰을 네이티브 레이어에 저장
  • 저장된 사용자 토큰을 삭제
공지

통신사 연동 SDK는 통신사 앱들만 사용 가능한 namespace로 nachocode 문의를 통해 기능 활성화가 가능합니다.

타입 정의​

TelecomUserTokenResult​

export declare type TelecomUserTokenResult = {
  status: 'success' | 'error';
  statusCode: number;
  message?: string;
};
속성명타입필수 여부설명
status'success' | 'error'✅토큰 작업 성공 여부
statusCodenumber✅결과 상태 코드
messagestring❌(optional) 에러 발생 시 상세 메시지

메서드 목록​

메서드설명추가된 버전
setTelecomUserToken(token)네이티브 레이어에 사용자 토큰을 설정합니다.SDKSDKv1.11.1
deleteTelecomUserToken()네이티브 레이어에 저장된 사용자 토큰을 삭제합니다.SDKSDKv1.11.1

메서드 상세​

setTelecomUserToken(token)​

타입 정의​

function setTelecomUserToken(token: string): Promise<TelecomUserTokenResult>;

설명​

네이티브 레이어에 통신사 앱의 사용자 토큰을 설정합니다.
인증 받은 토큰을 저장하여 연동 서비스에서 사용할 수 있도록 합니다.

매개변수​

파라미터타입필수 여부설명
tokenstring✅사용자 토큰 문자열

반환 값​

타입설명
Promise<TelecomUserTokenResult>사용자 토큰 설정 처리 결과

사용 예제​

// 통신사 인증 후 토큰 설정
const result = await Nachocode.telecom.setTelecomUserToken(
  'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
);
if (result.status === 'success') {
  console.log('사용자 토큰이 성공적으로 설정되었습니다.');
} else {
  console.error('사용자 토큰 설정 실패: ', result.message);
}

deleteTelecomUserToken()​

타입 정의​

function deleteTelecomUserToken(): Promise<TelecomUserTokenResult>;

설명​

네이티브 레이어에 저장된 통신사 앱의 사용자 토큰을 삭제합니다.
사용자 로그아웃, 회원 탈퇴, 토큰 만료 시 호출하여 저장된 토큰을 제거할 수 있습니다.

반환 값​

타입설명
Promise<TelecomUserTokenResult>사용자 토큰 삭제 처리 결과

사용 예제​

// 로그아웃 시 토큰 삭제
const result = await Nachocode.telecom.deleteTelecomUserToken();
if (result.status === 'success') {
  console.log('사용자 토큰이 성공적으로 삭제되었습니다.');
} else {
  console.error('사용자 토큰 삭제 실패: ', result.message);
}