본문으로 건너뛰기

통신사 (telecom)

Thumbnail Image

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

개요​

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

  • 사용자 토큰을 네이티브 레이어에 저장
  • 저장된 사용자 토큰을 삭제
  • 사용자 토큰의 존재 여부를 확인
공지

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

타입 정의​

TelecomUserTokenResult​

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

CheckTelecomUserTokenResult​

토큰 존재 여부 확인 결과 타입으로,
성공 시 CheckTelecomUserTokenSuccessResult,
실패 시 CheckTelecomUserTokenErrorResult를 반환합니다.

export declare type CheckTelecomUserTokenResult =
  | CheckTelecomUserTokenSuccessResult
  | CheckTelecomUserTokenErrorResult;

CheckTelecomUserTokenSuccessResult​

export declare type CheckTelecomUserTokenSuccessResult = {
  status: 'success';
  statusCode: 200;
  message: string;
  data: boolean;
};
속성명타입필수 여부설명
status'success'✅요청 성공 상태
statusCode200✅결과 상태 코드
messagestring✅결과 메시지
databoolean✅토큰이 존재하면 true, 존재하지 않으면 false

CheckTelecomUserTokenErrorResult​

export declare type CheckTelecomUserTokenErrorResult = {
  status: 'error';
  statusCode: 400 | 500;
  message: string;
};
속성명타입필수 여부설명
status'error'✅요청 실패 상태
statusCode400 | 500✅에러 상태 코드
messagestring✅에러 메시지

메서드 목록​

메서드설명추가된 버전
setTelecomUserToken(token)네이티브 레이어에 사용자 토큰을 설정합니다.SDKSDKv1.11.1
deleteTelecomUserToken()네이티브 레이어에 저장된 사용자 토큰을 삭제합니다.SDKSDKv1.11.1
checkTelecomUserToken()네이티브 레이어에 저장된 사용자 토큰의 존재 여부를 확인합니다.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);
}

checkTelecomUserToken()​

타입 정의​

function checkTelecomUserToken(): Promise<CheckTelecomUserTokenResult>;

설명​

네이티브 앱 레이어에 통신사 앱의 사용자 토큰이 저장되어 있는지 존재 여부를 확인합니다.
성공 시 data 값으로 토큰의 존재 여부(true / false)를 반환합니다.

활용 방법

쿠키나 세션 방식으로 로그인을 관리하는 경우, 웹에서는 로그인이 되어 있으나 네이티브 레이어의 토큰이 비어있는 상황이 발생할 수 있습니다. 이때 checkTelecomUserToken()으로 토큰 존재 여부를 확인하여, 토큰이 없는 경우 setTelecomUserToken()을 호출해 토큰을 다시 저장하는 방식으로 활용할 수 있습니다.

반환 값​

타입설명
Promise<CheckTelecomUserTokenResult>사용자 토큰 존재 여부 확인 결과

사용 예제​

// 토큰 존재 여부 확인 후 없으면 다시 저장
const result = await Nachocode.telecom.checkTelecomUserToken();

if (result.status === 'success') {
  if (result.data) {
    console.log('사용자 토큰이 저장되어 있습니다.');
  } else {
    console.log('사용자 토큰이 없습니다. 토큰을 다시 저장합니다.');
    // 웹 세션 등에서 토큰을 가져와 저장
    await Nachocode.telecom.setTelecomUserToken(token);
  }
} else {
  console.error('토큰 존재 여부 확인 실패: ', result.message);
}