Environment.getServerTime

函数式 API getServerTime也可以这样使用同样的功能。

功能说明

获取 Toss 应用服务器的当前时间，并以 Unix 时间戳（毫秒）获取。由于这是以服务器为基准，而不是设备时间，因此有助于减少因客户端时间篡改而产生的作弊。

Toss App Android/iOS 5.245.0 可在以上版本中使用。调用前 Environment.getServerTime.isSupported()可通过它确认是否支持。若在不支持的版本中调用， UNSUPPORTED_APP_VERSION 会发生错误。

类型

Environment.getServerTime(): Promise<number>;

Params

无

Response

将服务器时间以 Unix 时间戳（毫秒）返回。例如 1705123456789。

错误

错误代码是 catch 到的错误的 error.code 值。

代码	说明
UNSUPPORTED_APP_VERSION	如果当前运行的 Toss App 版本不支持此功能，调用后会立即发生。 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);
}