浏览文档
开始使用
选择正确的主机与凭据,通过一次免费请求验证访问。
本页内容
基础 URL
| 用途 | 基础 URL | 认证 |
|---|---|---|
| 数据查询与任务 | https://data.flashdata.dev/v1 | X-API-Key |
| 身份、余额、定价、限额及用量 | https://api.flashdata.dev/v2 | X-API-Key |
| 远程 MCP | https://data.flashdata.dev/mcp | 宿主管理 OAuth,或 X-API-Key |
认证请求头
REST 请求在 X-API-Key 中使用试用或所有者密钥。JSON 请求体使用 Content-Type: application/json。CLI 配置、SDK 环境和 MCP 连接分别存储凭据。
请求头
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json让 MCP 宿主通过登录获取、存储并刷新此令牌,仅用于 MCP 端点。使用 API Key 的宿主则发送 X-API-Key。
MCP 宿主管理的请求头
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN验证密钥
在终端运行。身份端点检查访问,不消耗 Credits。已设置 FLASHDATA_API_KEY 时,跳过密钥输入提示。
需要 Bash 与 cURL 7.76+。若环境已提供 FLASHDATA_API_KEY,跳过隐藏输入提示。在同一终端运行读取命令。
设置密钥 · 已配置可跳过
# 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读取账户 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,跳过隐藏输入提示。在同一终端运行读取命令。
设置密钥 · 已配置可跳过
# 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读取账户 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 200。检查预期账户、access: ready,以及 scopes 中的所需来源。临时密钥的 accountType 为 temporary;定时所有者任务要求 recurringAllowed: true。
所有者身份 · 响应节选示例
{
"accountId": "acc_example",
"apiKeyId": "key_example",
"accountType": "owned",
"access": "ready",
"scopes": [
"google_search"
],
"recurringAllowed": true
}签名存储 URL
结果和上传 URL 自带授权。访问返回的 URL 时,不附带 X-API-Key、OAuth 令牌或浏览器 Cookie。
认证故障排查
| 响应 | 下一步 |
|---|---|
| 401 | 检查当前环境密钥、有效期及撤销状态。使用有效 API Key,不用 MCP 令牌或 Bearer 前缀。 |
| 403 / 缺少来源 | 请所有者为此密钥授予所需来源。 |
| 免费读取返回 503 | 稍后重试读取。账户状态尚未验证,不要据此执行付费查询。 |