跳转到正文
中文
获取 API 密钥
浏览文档

开始使用

请求头与认证

选择正确的主机与凭据,通过一次免费请求验证访问。

本页内容

基础 URL

用途基础 URL认证
数据查询与任务https://data.flashdata.dev/v1X-API-Key
身份、余额、定价、限额及用量https://api.flashdata.dev/v2X-API-Key
远程 MCPhttps://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

验证密钥

在终端运行。身份端点检查访问,不消耗 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'
)

预期响应

预期 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稍后重试读取。账户状态尚未验证,不要据此执行付费查询。