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

Integrações

Opções de autenticação do agente

Conecte-se com uma chave API ou MCP OAuth, verifique o acesso sem uma consulta paga, e reutilize-o para tarefas posteriores.

Nesta página

1. Escolha e conecte-se

Já conectado? Vá direto para o verificação grátis no passo 2. Caso contrário, escolha o acesso que sua aplicação ou agente precisa.

Você está se conectandoUseQuem fica com a credencial?
Um aplicativo, SDK, CLI ou script agendadoChave APIA loja secreta do seu servidor ou o perfil CLI
Codex ou OpenClaw ferramentas de pesquisaMCP OAuthO anfitrião após o consentimento do navegador
Um agente tentando FlashData sem uma contaChave temporária APIO agente salvou o perfil do teste, e depois o acesso do proprietário depois de alegar

Crie uma chave no API Keys com as fontes que sua tarefa precisa, ou reutilize uma chave existente. Forneça-o para o seu SDK ou envie-o como X-API-Key de sua infraestrutura. Bash e PowerShell verificam na etapa 2 trabalham diretamente com API; nenhuma instalação CLI é necessária.

Que fontes essa credencial pode usar?

Use X-API-Key para pedidos normais de HTTP e conexões API-chave MCP. OAuth tokens ao portador funcionam apenas no ponto final hospedado do MCP. YouTube Download precisa de uma chave API com youtube_download e armazenamento de destino.

CredencialFontes disponíveis
Chave APIAs fontes concedidas à chave, incluindo youtube_download quando aprovado.
Chave temporária APIApenas fontes elegíveis para o teste. Leia os escopos da atual resposta de identidade.
MCP OAuthgoogle_search, youtube_search, youtube_metadata, youtube_transcript

Guarde uma chave no CLI

Pular importação se o CLI já tem acesso ou seu gerente secreto fornece FLASHDATA_API_KEY. Caso contrário, escolha um método abaixo e mantenha o mesmo perfil de pesquisa para comandos posteriores. Uma chave CLI salva não está disponível automaticamente para servidores SDKs ou MCP locais.

Cola a chave no terminal secreto.

Importar uma vez
flashdata auth login --profile research

2. Verifique a conexão

Faça a verificação gratuita no ambiente que irá realizar a tarefa. As verificações CLI e HTTP usam uma chave API; a verificação MCP usa a conexão salva do próprio hospedeiro.

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'
)

Leia a identidade da chave API

Os campos de identidade HTTP estão no nível superior. Em CLI JSON, leia data.identity.identity e requeira data.accessVerified: true. HTTP 200 ou CLI ok: true sozinho não é suficiente.

verificaçãoResultado necessário
Conta previstaaccountId e apiKeyId identificam a conta e a chave que você queria usar.
Acesso utilizávelaccess: ready
Permissão da tarefaescopos contém a fonte, como google_search. CLI também lista as fontes permitidas em data.identity.permittedSources.
Tarefa recorrenteaccountType: owned · installed: true · recurringAllowed: true

Um teste ativo é uma conexão válida

Um teste pode passar por uma tarefa única, enquanto recurringAllowed é false. Leia os escopos e expire, reclame o teste existente antes de agendar o trabalho.

Identidade temporária · campos ilustrativos
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}

Encontre a conexão em Codex

Liste os servidores configurados, e use /mcp em uma nova sessão Codex. Faça a verificação MCP acima para verificar a credencial.

Listar servidores
codex mcp list

Verifique a conexão em OpenClaw

Sonda o servidor salvo, então execute a verificação MCP acima em sua conversa ativa.

Sonda o servidor
openclaw mcp doctor flashdata --probe

3. Reutilize o acesso em tarefas futuras

Mantenha a loja de credenciais privada e persistente em todo o processo reiniciado. Verifique novamente o acesso em um novo processo antes de habilitar seu agendador.

CredencialPara a próxima tarefa
Chave APIReutilize a chave salva. Não tem nenhum passo de atualização OAuth; substitua se expirar ou revogar.
MCP OAuthO host atualiza fichas de acesso OAuth de uma hora usando fichas rotativas de atualização. Reconecte-se quando o subsídio de 90 expirar ou for revogado. Cada instalação possui sua loja de fichas, não compartilhe arquivos de atualização entre os anfitriões.
Chave temporária APITermino a vinculação do dono e a transferência de credenciais antes do trabalho recorrente. Reutilize o perfil original, não se registre novamente para cada corrida.

Verifique uma tarefa CLI antes de agendar

Requer Bash e jq. Defina a fonte da tarefa. O script usa pesquisa por padrão, definir FLASHDATA_PROFILE e FLASHDATA_STATE_DIR para um perfil ou diretório de estado diferente. Sair de 0 com identidade JSON significa que a chave do proprietário está pronta, instalada e permitida para esta fonte. Faça seu agendador parar em qualquer outra saída. Nenhuma consulta foi submetida.

Checagem de acesso de processo fresco. Bash
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
  args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi

flashdata auth status "${args[@]}" |
  jq -e --arg source "$SOURCE" '
    select(.ok == true and .data.accessVerified == true)
    | .data.identity as $auth
    | $auth.identity
    | select(.accountType == "owned" and .access == "ready"
        and .installed == true and .recurringAllowed == true
        and ((.scopes // []) | index($source) != null)
        and (($auth.permittedSources // []) | index($source) != null))
    | {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)

Se o acesso ainda for um teste

Complete o teste e reivindique o guia com o perfil original. Após aprovação do proprietário e transferência de credenciais, o verificação livre deve mostrar acesso próprio e recurringAllowed: true. Pedidos contínuos usam o equilíbrio compartilhado do proprietário, créditos não usados não são transferidos. MCP OAuth login é uma conexão separada e não reivindica este teste.

Revogar o acesso

Pausar trabalhos recorrentes primeiro. Revogar a credencial correspondente abaixo, então repetir a verificação livre de um novo processo ou sessão antes de limpar o acesso local. Espere falha na autenticação ou um pedido de reconexão; não aprove uma nova conexão durante a verificação. O login local sozinho não revoga o acesso ao servidor.

LigaçãoOnde revogar?
MCP OAuthSettings → Connected apps → A bolsa do aplicativo.
Alegado agente API chaveSettings → Connected apps → Conexões de agentes.
Conta API chaveAPI Keys → a chave usada por esta integração.

Conserte uma verificação falhada

ResultadoAção
accessVerified: falseFase de leitura e nextCommand. Um perfil pendente pode devolver ok: true antes que uma chave seja utilizável. Termine seu registro ou vinculação, mantenha o mesmo perfil.
access: blockedPare mesmo que a resposta HTTP fosse 200. Revise a conta ou conexão no console, não trate uma resposta de identidade como permissão para perguntar.
accountType: temporaryUse o teste elegível para um trabalho único. Reclame antes de agendar, uma nova conexão OAuth não reivindica este perfil.
installed: falseApós a aprovação do proprietário, execute flashdata auth finish --wait com o perfil original e diretório de estado. Então repita o verificação.
401 / invalid_grantReconectar a credencial expirada ou revogada em seu hospedeiro original. Não comece outro teste para evitar.
403 / source_forbiddenVerifique os escopos da chave ou a lista de fontes OAuth. YouTube Download usa uma chave API do proprietário.
Acesso válido, equilíbrio zeroA autenticação funcionou. Verifique Billing antes do trabalho pago, não substitua uma chave válida.