requireValidToken

function requireValidToken(
  token: unknown,
  allowedKeys: string | string[] | Record<string, unknown>,
  message: string = "Invalid API key."
): string;

Разрешённые ключи можно передать одной строкой, списком или объектом, ключи которого и есть токены. Это проверка на входе веб-приложения: она возвращает токен, чтобы вызов читался одним выражением, а иначе бросает именованное исключение.

Параметры

Параметр	Тип	Описание
`token`	`unknown`	Токен, предъявленный вызывающей стороной.
`allowedKeys`	`string \\| string[] \\| Record<string, unknown>`	Один ключ, список ключей или объект с ключами-токенами.
`message` (необязательный) `= "Invalid API key."`	`string`	Сообщение исключения. По умолчанию `"Invalid API key."`.

Возвращает

string — тот же токен.

Исключения

Исключение	Условие
`AuthenticationException`	токен отсутствует или не совпал ни с одним разрешённым ключом.

Примеры

Применение

function doPost(event) {
  const key = requireValidToken(
    event.parameter.key,
    PropertiesService.getScriptProperties().getProperty("API_KEYS").split(","),
    "Unknown API key."
  );

  // … the request is from someone we know
}

Смотрите также

Исходный код

src/appsscript/net/requireValidToken.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.