Environment.getServerTime

함수형 API getServerTime으로도 같은 기능을 쓸 수 있어요.

기능 설명

토스 앱 서버의 현재 시간을 Unix timestamp(밀리초)로 가져와요. 디바이스 시간이 아니라 서버 기준이라 클라이언트 시간 조작에 따른 치팅을 줄이는 데 도움이 돼요.

토스앱 Android/iOS 5.245.0 이상에서 사용할 수 있어요. 호출 전에 Environment.getServerTime.isSupported()로 지원 여부를 확인할 수 있어요. 미지원 버전에서 호출하면 UNSUPPORTED_APP_VERSION 에러가 발생해요.

타입

Environment.getServerTime(): Promise<number>;

Params

없음

Response

서버 시간을 Unix timestamp(밀리초)로 반환해요. 예를 들어 1705123456789예요.

에러

에러 코드는 catch한 에러의 error.code 값이에요.

코드	설명
UNSUPPORTED_APP_VERSION	실행 중인 토스앱 버전이 이 기능을 지원하지 않으면 호출 즉시 발생해요. Environment.getServerTime.isSupported()로 사전 확인하고, 발생 시 error.message(업데이트 안내 문구)를 사용자에게 보여주세요.

예시 코드

import { Environment } from "@apps-in-toss/web-framework";

try {
  const serverTime = await Environment.getServerTime();
  console.log(serverTime);
} catch (error) {
  console.error(error);
}