Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Primeiros passos

Cabeçalhos e autenticação

Use o host e a credencial corretos e verifique o acesso com uma requisição gratuita.

Nesta página

Base URLs

PropósitoBase URLAutenticação
Consultas de dados e trabalhoshttps://data.flashdata.dev/v1X-API-Key
Identidade, equilíbrio, preços, limites e usohttps://api.flashdata.dev/v2X-API-Key
MCPhttps://data.flashdata.dev/mcpOAuth, 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.

Requisito cabeçalhos
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json

Verifique 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.

Defina a tecla · skip se já configurado
# 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
Leia a conta 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'
)

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.

Identidade do proprietário. Excerto de resposta ilustrativa
{
  "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

RespostaPróximo passo
401Verifique 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 faltandoPeça ao dono para dar a fonte necessária para esta chave.
503 nesta leitura grátisTente ler mais tarde. O status da conta não foi verificado, não deduza que uma consulta paga está pronta.