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) на основі вихідного коду бібліотеки.