API 的关键概念

API 密钥是一种凭证，它将纯文本密钥值与特定的 Amazon Location Service 资源和允许的操作关联起来。当您的应用程序在请求中包含 API 密钥时，Amazon Location Service 会根据密钥的配置对请求进行授权，而无需进行任何其他身份验证。

键值

用于对 API 请求进行身份验证的纯文本字符串。密钥值遵循格式v1.public.a1b2c3d4...。您可以将此值作为key参数包含在 API 请求中。

限制

定义 API 密钥能做什么的控件。限制包括允许的操作（密钥可以调用哪些 API）和允许的资源（密钥可以访问哪些资源）。在创建或更新密钥时，您可以配置限制。

客户限制

对 API 密钥的使用位置的可选限制。您可以将密钥限制为特定的网域（使用 HTTP Referer 标头）、Android 应用程序（使用软件包名称和签名证书）或 Apple 应用程序（使用软件包 ID）。

过期

一个可选的时间戳，之后自动停用 API 密钥。使用 expiration 强制定期轮换密钥或创建临时密钥。没有过期时间的密钥会无限期地保持活动状态。

密钥状态

API 密钥要么处于活动状态（可用于发出请求），要么处于非活动状态（手动或过期停用）。非活动密钥无法对请求进行身份验证，可在 90 天后删除。