浏览文档
开始使用
为应用或智能体创建密钥,保存并检查访问,管理其生命周期。
本页内容
1. 创建密钥
- 登录已验证账户,打开 API Keys。已有授权密钥时可直接复用。
- 以应用和环境命名,选择有效期及所需来源。首次搜索示例选择 Google Search。
- 创建密钥并按下方方式保存。独立智能体和生产应用分别使用密钥,以便单独撤销。
2. 保存密钥
选择运行 FlashData 的方式。API 与 SDK 示例读取 FLASHDATA_API_KEY;CLI 可将密钥保存到受保护配置。生产环境从密钥存储注入凭据。
为当前终端设置密钥
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY为当前终端设置密钥
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey在隐藏提示中粘贴密钥。使用命名配置时,在此处及后续命令中追加 --profile NAME。配置已有密钥时,使用 login --replace 才会替换。
保存密钥
flashdata auth login3. 验证访问
在同一终端或 CLI 配置运行免费检查,选择与密钥保存方式对应的选项卡。
在同一终端复用前面检查时设置的 FLASHDATA_API_KEY。
读取账户 JSON
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)在同一终端复用前面检查时设置的 FLASHDATA_API_KEY。
读取账户 JSON
& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/identity"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}确认账户与来源
HTTP 直接返回这些字段。CLI JSON 将其放在 data.identity.identity 中,还应检查 data.accessVerified: true。
| 检查项 | 预期 |
|---|---|
| accountId | 此工作负载所属账户。 |
| access | ready |
| scopes | 首次搜索需包含 google_search。 |
| recurringAllowed | 定时所有者任务前应为 true。 |
来源权限如何生效
密钥只能使用获授来源。产品选择与定价独立,账户全部密钥使用共享余额,包括购买的 Credits。受限密钥没有独立消费上限,未来产品需要明确授权。
密钥泄露时
轮换密钥
- 创建具有所需来源的替换密钥,安装到目标环境。
- 重复上方免费验证,再切换应用或调度器。更新每个预期调用方。
- 调用方切换后撤销旧密钥。修改本机密钥不会更新已部署服务。
替换 CLI 密钥 · 在隐藏提示输入
flashdata auth login --replace
flashdata auth status撤销访问
停止定时调用方,在下方对应位置撤销密钥或连接,再以旧凭据重复免费验证,确认请求被拒绝。本地退出登录不会撤销服务器访问。
| 访问类型 | 撤销位置 |
|---|---|
| 普通 API Key | API Keys |
| 已认领智能体密钥 | Settings → Connected apps → Agent connections |
| MCP OAuth 授权 | Settings → Connected apps |