Jelajahi dokumentasi
Integrasi
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 menyambung | Gunakan | Siapa yang menjaga kredensial? |
|---|---|---|
| Aplikasi, SDK, CLI atau skrip yang dijadwalkan | Kunci pemilik API | Penyimpanan rahasia server Anda atau profil CLI |
| Codex atau OpenClaw alat penelitian | MCP OAuth | Host setelah persetujuan peramban |
| Seorang agen mencoba FlashData tanpa akun | Kunci sementara API | Agen 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.
Gunakan host yang dikonfigurasi untuk FlashData OAuth. Pemilik akun melengkapi pendaftaran atau tandatangan dan persetujuan dalam peramban; host menyimpan token. Koneksi ini tidak menginstal kunci CLI atau mengklaim percobaan.
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:researchUntuk seorang agen tanpa kunci, discover percobaan saat ini eligibilitas sebelum mendaftar. Gunakan ulang percobaan yang ada dan profilnya. YouTube Download dan tugas yang berulang memerlukan akses pemilik.
flashdata discover --profile research --jsonSumber 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.
| Kredensial | Sumber tersedia |
|---|---|
| Kunci pemilik API | Sumber diberikan ke kunci, termasuk youtube_download ketika disetujui. |
| Kunci sementara API | Hanya diberikan trial - sumber yang memenuhi syarat. Baca scopes dari respon identitas saat ini. |
| MCP OAuth | google_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.
flashdata auth login --profile researchSet FLASHDATA_KEY_FILE ke lokasi dari berkas kunci yang telah ada. Perintah membacanya melalui stdin; menjaga kunci keluar dari percakapan dan argumen perintah.
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
< "$FLASHDATA_KEY_FILE"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.
# 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'
)Lewati prompt kunci tersembunyi jika FLASHDATA_API_KEY telah diset. Jalankan perintah baca di terminal yang sama.
# 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
}Gunakan pengguna OS, profil, dan status direktori dari login. Gantikan penelitian jika Anda menggunakan profil lain; tambahkan --state-dir PATH jika diperlukan. FLASHDATA_API_KEY menimpa kunci yang disimpan. Mengharapkan ok: true dan data.accessVerified: true, kemudian memeriksa bidang identitas di bawah ini.
flashdata auth status --profile research --json --non-interactiveKirim ini ke sesi baru dari agen anda yang terhubung. Ganti google_search dengan sumber kebutuhan tugas Anda. Berharap kedua alat tersebut sukses; periksa harga dan keseimbangan secara terpisah sebelum dibayar. Sebuah server terdaftar saja tidak memverifikasi akses.
Gunakan flashdata yang ada koneksi MCP.
Call get_pricing dengan {"source":"google_search","request_count":1}.
Call get_balance dengan {}.
Laporkan apakah kedua panggilan berhasil, apakah sumber memiliki harga yang tersedia,
dan saldo kredit yang tersedia. Sebuah keseimbangan nol bukan sebuah kegagalan otentikasi.
Jangan jalankan pencarian atau unduh, buat uji coba, atau ubah kredensial.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.
| Periksa | Hasil yang diperlukan |
|---|---|
| Akun yang ditambahkan | accountId dan apiKeyId mengidentifikasi akun dan kunci yang Anda maksud untuk digunakan. |
| Akses yang dapat digunakan | access: ready |
| Izin tugas | scopes berisi sumber, seperti google_search. CLI juga daftar sumber yang diijinkan dalam data.identity.permittedSources. |
| Mengulang tugas | accountType: 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.
{
"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.
codex mcp listPeriksa sambungan dalam OpenClaw
Probe server disimpan, kemudian jalankan MCP cek di atas dalam percakapan aktif Anda.
openclaw mcp doctor flashdata --probe3. 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.
| Kredensial | Untuk tugas berikutnya |
|---|---|
| Kunci pemilik API | Gunakan kembali kunci yang disimpan. Tidak ada OAuth langkah refresh; menggantinya jika kadaluarsa atau dicabut. |
| MCP OAuth | Host 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 API | Selesai 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.
(
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.
| Koneksi | Dimana untuk mencabut |
|---|---|
| MCP OAuth | SettingsQ Connected apps Hibah aplikasi. |
| Agen yang diklaim kunci API | SettingsQ Connected apps Agen koneksi. |
| Kunci Akun API | API KeysQ kunci yang digunakan oleh integrasi ini. |
Perbaiki pengecekan gagal
| Hasil | Aksi |
|---|---|
| accessVerified: false | Baca 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: blocked | Hentikan bahkan jika respon HTTP adalah 200. Tinjau akun atau koneksi dalam konsol; jangan perlakukan respon identitas sebagai hak untuk query. |
| accountType: temporary | Gunakan pengadilan yang memenuhi syarat untuk satu pekerjaan. Klaim sebelum penjadwalan; koneksi OAuth baru tidak mengklaim profil ini. |
| installed: false | Setelah persetujuan pemilik, jalankan data kilas auth finish --wait dengan profil asli dan direktori keadaan. Kemudian ulangi cek. |
| 401 / invalid_grant | Rekonnect yang kadaluwarsa atau dicabut kredensial di tuan rumah aslinya. Jangan memulai percobaan lain untuk melewatinya. |
| 403 / source_forbidden | Periksa data kunci atau daftar sumber OAuth. YouTube Download menggunakan pemilik API kunci. |
| Akses yang valid, keseimbangan nol | Otentikasi berhasil. Periksa Billing sebelum pekerjaan yang dibayar; jangan ganti kunci yang valid. |