Explorar documentação
Primeiros passos
Use o host e a credencial corretos e verifique o acesso com uma requisição gratuita.
Nesta página
Base URLs
| Propósito | Base URL | Autenticação |
|---|---|---|
| Consultas de dados e trabalhos | https://data.flashdata.dev/v1 | X-API-Key |
| Identidade, equilíbrio, preços, limites e uso | https://api.flashdata.dev/v2 | X-API-Key |
| MCP | https://data.flashdata.dev/mcp | OAuth, ou X-API-Key |
Cabeçalhos de autenticação
Requisitos REST usam X-API-Key com uma chave de teste ou proprietário. Envie corpos JSON com Content-Type: application/json. Perfis CLI, ambientes SDK e conexões MCP armazenam credenciais separadamente.
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/jsonDeixe o anfitrião do MCP obter, armazenar e atualizar este token através do login. Use-o apenas no ponto final do MCP. Hospedeiros usando uma chave API em vez disso enviem X-API-Key.
Authorization: Bearer YOUR_MCP_ACCESS_TOKENVerifique sua chave
Passe isso no seu terminal. A identidade verifica o acesso sem gastar créditos. Pule o prompt se o FLASHDATA_API_KEY já estiver pronto.
Requer Bash e cURL 7.76+. Pule a chave secreta se seu ambiente já fornecer FLASHDATA_API_KEY. Execute os comandos de leitura no mesmo terminal.
# 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(
: "${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'
)Pule o prompt de chave escondida se FLASHDATA_API_KEY já está definido. Execute os comandos de leitura no mesmo terminal.
# 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& {
$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
}Espera-se resposta
Espere HTTP 200. Verifique a conta pretendida, access: ready e sua fonte em escopos. Uma chave temporária tem accountType: temporary; o trabalho recorrente do proprietário requer recurringAllowed: true.
{
"accountId": "acc_example",
"apiKeyId": "key_example",
"accountType": "owned",
"access": "ready",
"scopes": [
"google_search"
],
"recurringAllowed": true
}Armazenamento assinado URLs
Resultado e upload URLs incluem sua própria autorização. Siga o URL retornado sem X-API-Key, OAuth tokens ou cookies do navegador.
Autenticação de problemas
| Resposta | Próximo passo |
|---|---|
| 401 | Verifique a chave neste ambiente, sua expiração e revogação. Use uma chave API atual, não um símbolo MCP ou um prefixo do portador. |
| 403 / fonte faltando | Peça ao dono para dar a fonte necessária para esta chave. |
| 503 nesta leitura grátis | Tente ler mais tarde. O status da conta não foi verificado, não deduza que uma consulta paga está pronta. |