Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Integrasi

Opsi otentikasi agen

Hubungkan dengan API kunci atau MCP OAuth, verifikasi akses tanpa kuiri dibayar, dan gunakan lagi untuk tugas kemudian.

Di halaman ini

1. Pilih dan hubungkan

Sudah terhubung? Pergi langsung ke cek gratis di langkah 2. Jika tidak, pilih akses yang dibutuhkan atau agen anda.

Anda sedang menyambungGunakanSiapa yang menjaga kredensial?
Aplikasi, SDK, CLI atau skrip yang dijadwalkanKunci pemilik APIPenyimpanan rahasia server Anda atau profil CLI
Codex atau OpenClaw alat penelitianMCP OAuthHost setelah persetujuan peramban
Seorang agen mencoba FlashData tanpa akunKunci sementara APIAgen apos; s profil pengadilan disimpan, kemudian pemilik akses setelah mengklaim

Buat kunci dalam API Keys dengan sumber yang diperlukan tugas Anda, atau gunakan kembali kunci yang telah ada. Pasokan ke SDK Anda atau kirim sebagai X-API-Key dari backend Anda. Bash dan PowerShell cek langkah 2 bekerja langsung dengan API; tidak ada instalasi CLI yang diperlukan.

Sumber mana yang bisa digunakan kredensial ini?

Gunakan X-API-Key untuk permintaan HTTP normal dan sambungan APIQ-kunci MCP normal. OAuth pembawa token hanya bekerja di titik akhir MCP yang diselenggarakan. YouTube Download membutuhkan pemilik kunci API dengan youtube_download dan penyimpanan tujuan.

KredensialSumber tersedia
Kunci pemilik APISumber diberikan ke kunci, termasuk youtube_download ketika disetujui.
Kunci sementara APIHanya diberikan trial - sumber yang memenuhi syarat. Baca scopes dari respon identitas saat ini.
MCP OAuthgoogle_search, youtube_search, youtube_metadata, youtube_transcript

Simpan kunci di CLI

Abaikan impor jika CLI sudah memiliki akses atau persediaan manajer rahasia Anda FLASHDATA_API_KEY. Jika tidak, pilih metode di bawah ini dan tetap sama profil penelitian untuk perintah kemudian. Kunci CLI yang disimpan tidak secara otomatis tersedia untuk SDK atau server lokal MCP.

Tempelkan kunci pada prompt terminal tersembunyi.

Impor sekali
flashdata auth login --profile research

2. Verifikasi sambungan

Jalankan pemeriksaan gratis di lingkungan yang akan melakukan tugas. CLI dan HTTP cek menggunakan kunci API; cek MCP menggunakan sambungan sendiri yang disimpan oleh host.

Membutuhkan Bash dan cURL 7.76 +. Lewati prompt kunci tersembunyi jika lingkungan anda sudah menyediakan FLASHDATA_API_KEY. Jalankan perintah baca di terminal yang sama.

Atur kunci bila sudah dikonfigurasi
# 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
Baca akun 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'
)

Baca API-key identitas

HTTP bidang identitas berada di tingkat atas. Dalam CLI JSON, dibaca data.identity.identity dan membutuhkan data.accessVerified: true. HTTP 200 atau CLI ok: true sendirian tidak cukup.

PeriksaHasil yang diperlukan
Akun yang ditambahkanaccountId dan apiKeyId mengidentifikasi akun dan kunci yang Anda maksud untuk digunakan.
Akses yang dapat digunakanaccess: ready
Izin tugasscopes berisi sumber, seperti google_search. CLI juga daftar sumber yang diijinkan dalam data.identity.permittedSources.
Mengulang tugasaccountType: owned · installed: true · recurringAllowed: true

Persidangan aktif adalah koneksi yang valid

Sebuah percobaan dapat melewati satu-off-tugas cek sementara recurringAllowed adalah false. Baca pandangan sebenarnya dan kadaluarsa; klaim percobaan yang ada sebelum penjadwalan bekerja.

Identitas sementara
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}

Temukan koneksi dalam Codex

Daftar server yang dikonfigurasi, lalu gunakan /mcp dalam sesi Codex yang baru. Jalankan MCP cek di atas untuk memverifikasi kredensial.

Daftar server
codex mcp list

Periksa sambungan dalam OpenClaw

Probe server disimpan, kemudian jalankan MCP cek di atas dalam percakapan aktif Anda.

Probe server
openclaw mcp doctor flashdata --probe

3. Gunakan kembali akses untuk tugas selanjutnya

Menjaga swasta credential toko dan gigih di seluruh proses memulai kembali. Periksa ulang akses dalam proses baru sebelum mengaktifkan penjadwal Anda.

KredensialUntuk tugas berikutnya
Kunci pemilik APIGunakan kembali kunci yang disimpan. Tidak ada OAuth langkah refresh; menggantinya jika kadaluarsa atau dicabut.
MCP OAuthHost menyegarkan satu-jam token akses OAuth menggunakan token refresh berputar. Rekonnect ketika 90-day hibah berakhir atau dicabut. Setiap instalasi memiliki toko token nya; jangan berbagi segar-token berkas antara host.
Kunci sementara APISelesai pemilik mengklaim dan dokumen handoff sebelum recurring bekerja. Gunakan kembali profil asli; jangan mendaftar lagi untuk setiap dijalankan.

Periksa tugas CLI sebelum penjadwalan

Membutuhkan Bash dan jq. Atur SOURCE ke sumber tugas. Skrip menggunakan riset secara baku; set FLASHDATA_PROFILE dan FLASHDATA_STATE_DIR untuk profil atau direktori negara yang berbeda. Keluar 0 dengan identitas JSON berarti kunci pemilik siap, terpasang dan diijinkan untuk sumber ini. Apakah penjadwalan Anda berhenti pada setiap pintu keluar lain. Tak ada permintaan yang diajukan.

Pemeriksaan akses proses baru 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}'
)

Jika akses masih percobaan

Lengkap sidang dan mengklaim panduan dengan profil asli. Setelah pemilik persetujuan dan surat perlindungan, cek gratis harus menunjukkan akses yang dimiliki dan recurringAllowed: true. Permintaan terus-menerus menggunakan keseimbangan berbagi pemilik; kredit pengadilan tidak digunakan tidak transfer. MCP OAuth adalah sambungan terpisah dan tidak mengklaim sidang ini.

Menghilangkan akses

Jeda tugas yang berulang dulu. Mengembalikan kredensial yang cocok di bawah ini, kemudian ulangi cek gratis dari proses yang segar atau sesi sebelum membersihkan akses lokal. Mengharapkan kegagalan otentikasi atau permintaan reconnect; jangan menyetujui koneksi baru selama pemeriksaan. Logout lokal saja tidak mencabut akses server.

KoneksiDimana untuk mencabut
MCP OAuthSettingsQ Connected apps Hibah aplikasi.
Agen yang diklaim kunci APISettingsQ Connected apps Agen koneksi.
Kunci Akun APIAPI KeysQ kunci yang digunakan oleh integrasi ini.

Perbaiki pengecekan gagal

HasilAksi
accessVerified: falseBaca fase dan nextCommand. Profil yang tertunda dapat kembali ok: true sebelum kunci dapat digunakan. Selesaikan pendaftaran yang disimpan atau klaim; pertahankan profil yang sama.
access: blockedHentikan bahkan jika respon HTTP adalah 200. Tinjau akun atau koneksi dalam konsol; jangan perlakukan respon identitas sebagai hak untuk query.
accountType: temporaryGunakan pengadilan yang memenuhi syarat untuk satu pekerjaan. Klaim sebelum penjadwalan; koneksi OAuth baru tidak mengklaim profil ini.
installed: falseSetelah persetujuan pemilik, jalankan data kilas auth finish --wait dengan profil asli dan direktori keadaan. Kemudian ulangi cek.
401 / invalid_grantRekonnect yang kadaluwarsa atau dicabut kredensial di tuan rumah aslinya. Jangan memulai percobaan lain untuk melewatinya.
403 / source_forbiddenPeriksa data kunci atau daftar sumber OAuth. YouTube Download menggunakan pemilik API kunci.
Akses yang valid, keseimbangan nolOtentikasi berhasil. Periksa Billing sebelum pekerjaan yang dibayar; jangan ganti kunci yang valid.