Semak dokumentasi
Integrasi
Berhubung dengan API Kunci atau kunci MCP OAuth, verifikasi akses tanpa pertanyaan yang terbayar, dan gunakan lagi untuk tugas-tugas selanjutnya.
Pada halaman ini
1. Pilih dan sambungkan
Sudah terhubung? Pergi langsung ke pemeriksaan bebas dalam langkah 2. Jika tidak, pilihlah akses aplikasi atau kebutuhan agenmu.
| Kau sedang menyambung | Guna | Siapa yang menyimpan buktinya? |
|---|---|---|
| Sebuah aplikasi, SDK, CLI atau skrip terjadwal | Kunci API Pemilik Aus | Toko rahasia server anda atau profil CLI |
| Alat penelitian Codex atau OpenClaw | MCP OAuth | Host setelah persetujuan browser |
| Agen agen agen frenia mencoba FlashData tanpa akun | Kunci Sementara API | Agen itu menyelamatkan profil pengadilan, kemudian akses pemilik setelah mengklaim |
Achieved Buat kunci dalam API Keys dengan sumber yang anda butuhkan, atau gunakan kembali kunci yang ada. Kirimkan ke SDK-mu atau kirim sebagai X-API-Key dari belakangmu. Pemeriksaan Bash dan PowerShell dalam langkah 2 bekerja langsung dengan API; tidak ada instalasi CLI yang diperlukan.
Use a host dikonfigurasi untuk FlashData OAuth. Pemilik akun telah menyelesaikan pendaftaran atau pendaftaran dan persetujuan dalam browser; pembawa acara menyimpan token. Koneksi ini tidak memasang kunci CLI atau mengklaim pengadilan.
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:researchUntuk agen tanpa kunci, discover, kemungkinan percobaan saat ini sebelum mendaftar. Dia menggunakan kembali percobaan dan profilnya. PULAU YouTube Download dan tugas yang berulang memerlukan akses pemilik.
flashdata discover --profile research --jsonSumber mana yang dapat digunakan secara kredensial ini?
Use X-API-Key untuk permintaan HTTP normal dan API-key MCP koneksi. token pembawa OAuth hanya bekerja di titik akhir MCP yang dihos. YouTube Download kebutuhan kebutuhan seorang pemilik API Kunci dengan youtube_download Tempat penyimpanan dan destinasi.
| Bukti Bukti Bukti Kelayakan | Sumber yang ada |
|---|---|
| Kunci API Pemilik Aus | Sumber-sumber diberikan ke kunci, termasuk youtube_download ketika disetujui. |
| Kunci Sementara API | Dia hanya diberikan sumber-sumber yang memenuhi syarat. Skop baca dari tanggapan identitas saat ini. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |
Simpan kunci di CLI
Skip skip impor jika CLI sudah memiliki akses atau persediaan manajer rahasia Anda FLASHDATA_API_KEY. Jika tidak, pilihlah metode di bawah ini dan simpanlah profil penelitian yang sama untuk perintah di kemudian hari. Kunci CLI tersimpan tidak tersedia secara otomatis untuk SDK atau server MCP lokal.
Tempelkan kunci di terminal tersembunyi.
flashdata auth login --profile researchFLASHDATA_KEY_FILE Set ke jalan dari file kunci terlindungi yang sudah ada. Perintah tersebut membacanya melalui stdin; menjaga kunci dari chat 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. Simak sambungannya
Anda harus menjalankan cek gratis di lingkungan yang akan melakukan tugas. CLI Dan HTTP Periksa menggunakan sebuah API Kuncinya; MCP Pemeriksaan wanji menggunakan sambungan yang disimpan oleh host sendiri.
Kemudia membutuhkan Bash dan cURL 7.76+. Skip key propt tersembunyi jika lingkungan Anda sudah memasok 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'
)Skip key prompt tersembunyi jika FLASHDATA_API_KEY sudah ditetapkan. 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
}Guna pengguna OS, profil dan direktori keadaan dari log masuk. Gantikan riset jika menggunakan profil lain; tambahkan --state-dir PATH jika diperlukan. FLASHDATA_API_KEY membatalkan kunci yang disimpan. Expect ok: true dan data.accessVerified: true; kemudian menginspeksi medan identitas di bawah.
flashdata auth status --profile research --json --non-interactiveKirim ini ke sesi baru agenmu yang terhubung. Gantikan google_search dengan sumber yang dibutuhkan tugas anda. Exporex mengharapkan kedua panggilan alat untuk berhasil; memeriksa pricing dan saldo secara terpisah sebelum pekerjaan dibayar. Pengguna server yang terdaftar sendiri tidak memverifikasi akses.
Guna koneksi flashdata MCP yang sudah ada.
Panggil get_pricing dengan {"source":"google_search","request_count":1}.
Panggil get_balance dengan {}.
Laporan apakah kedua panggilan berhasil, apakah sumber memiliki harga yang tersedia,
Dan saldo kredit yang tersedia. Keseimbangan nol bukanlah kegagalan autentikasi.
Jangan jalankan pencarian atau download, buat sidang, atau ubah kredensial.Baca identitas kunci API
Bidang identitas HTTP berada di tingkat teratas. CLI JSON, baca data.identity.identity dan membutuhkan data.accessVerified: true. HTTP 200 OR atau ORANG CLI ok: true Hanya saja tidak cukup.
| Periksa | Hasil yang dibutuhkan |
|---|---|
| Akun yang Diintended | accountId dan apiKeyId mengidentifikasi akun dan kunci yang ingin anda gunakan. |
| Akses yang dapat digunakan | access: ready |
| Diizinkan oleh: | Skop Skop mengandung sumber, seperti google_search. CLI juga mencantumkan sumber yang diizinkan dalam data.identity.permittedSources. |
| Tugas yang berulang | accountType: owned · installed: true · recurringAllowed: true |
Uji coba aktif adalah koneksi yang valid
Uji coba A dapat melewati pemeriksaan satu-off tugas sementara recurringAllowed adalah false. CONCANA membaca lingkup dan ekspira yang sebenarnya; klaim pengadilan yang ada sebelum pekerjaan penjadwalan.
{
"accountType": "temporary",
"access": "ready",
"installed": false,
"recurringAllowed": false,
"scopes": [
"google_search"
]
}Cari koneksi dalam Codex
Senaraikan server yang dikonfigurasi, kemudian gunakan /mcp dalam sesi Codex segar. Jalankan pemeriksaan MCP di atas untuk memverifikasi kelayakan.
codex mcp listPeriksa koneksi dalam OpenClaw
Iaquina Probe server tersimpan, kemudian jalankan pemeriksaan MCP di atas dalam percakapan aktif Anda.
openclaw mcp doctor flashdata --probe3. Memulihkan kembali akses untuk tugas-tugas selanjutnya
Tetap simpan secara kredensial dan persisten sepanjang proses start ulang. Periksa kembali akses dalam proses baru sebelum mengaktifkan penjadwalan Anda.
| Bukti Bukti Bukti Kelayakan | Untuk tugas berikutnya |
|---|---|
| Kunci API Pemilik Aus | Gunakan kembali kunci yang disimpan. Ini tidak memiliki langkah penyegaran OAuth; menggantinya jika sudah habis atau dicabut. |
| MCP OAuth | Most me-refresh satu jam OAuth token akses menggunakan refresh token berputar. Putuskan kembali ketika hibah 90-hari berakhir atau dicabut. Setiap instalasi memiliki toko tokennya; jangan berbagi berkas-berkas yang disegarkan di antara host. |
| Kunci Sementara API | Penghapusan owner yang mengaku dan pengalihan kredensial sebelum pekerjaan berulang. Anda menggunakan kembali profil asli; jangan mendaftar lagi untuk setiap lari. |
Periksa tugas CLI sebelum penjadwalan
Kemudia membutuhkan Bash dan jq. Kami sudah menetapkan sumber tugas. script menggunakan penelitian secara default; set FLASHDATA_PROFILE dan FLASHDATA_STATE_DIR untuk profil atau direktori negara yang berbeda. Exit 0 dengan identitas JSON berarti kunci pemilik sudah siap, terpasang dan diizinkan untuk sumber ini. Apakah jadwal Anda berhenti di jalan keluar lain. Tidak ada pertanyaan 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 pengadilan
Melengkapi persidangan dan mengklaim panduan dengan profil asli. Setelah persetujuan pemilik dan pemberian kredensial, cek gratis harus menunjukkan akses yang dimiliki dan recurringAllowed: true. Permintaan yang diteruskan menggunakan saldo bersama pemilik; kredit pengadilan yang tidak digunakan tidak dipindahkan. Log masuk MCP OAuth adalah sambungan terpisah dan tidak mengklaim pengadilan ini.
Akses Relorge
Pekerjaan yang berulang pertama kali berulang kali tidak berulang. Membatalkan kredensial yang cocok di bawah ini, kemudian ulangi cek bebas dari proses atau sesi baru sebelum membersihkan akses lokal. Kegagalan pengesahan yang diharapkan oleh purgen atau permintaan sambung kembali; tidak menyetujui sambungan baru selama pemeriksaan. Logkeluar lokal logkeluar sendiri tidak mencabut akses server.
| Sambungan | Di mana harus membatalkan |
|---|---|
| MCP OAuth | Settings → Connected apps → hibah aplikasi. |
| Kunci agen API yang diklaim oleh THE | Settings → Connected apps → Hubungan Agen. |
| Akun API Kuncinya adalah | API Keys → kunci yang digunakan oleh integrasi ini. |
Fix sebuah pemeriksaan gagal
| Hasil | Aksi |
|---|---|
| accessVerified: false | Fasa baca dan nextCommand. Profil yang tertunda dapat mengembalikan ok: true sebelum kunci dapat digunakan. Finish pendaftaran atau klaim yang disimpan; mempertahankan profil yang sama. |
| access: blocked | Stop bahkan jika respon HTTP adalah 200. Tinjau kembali akun atau koneksi dalam konsol; jangan anggap tanggapan identitas sebagai izin untuk bertanya. |
| accountType: temporary | Gunakan pengadilan yang memenuhi syarat untuk satu pekerjaan. Klaim klaimnya sebelum penjadwalan; koneksi OAuth baru tidak mengklaim profil ini. |
| installed: false | Setelah persetujuan pemilik, jalankan flashdata auth finish --wait dengan profil dan direktori negara asli. Kalau begitu ulangi ceknya. |
| 401 / invalid_grant | Putuskan kembali kredensial yang telah luput atau dicabut dalam tuan rumah aslinya. Jangan memulai percobaan lain untuk melewatinya. |
| 403 / source_forbidden | Periksa skop kunci atau daftar sumber OAuth. YouTube Download menggunakan kunci API pemilik. |
| Akses sah, keseimbangan nol | Autentifikasi AVE bekerja. Periksa Billing sebelum pekerjaan berbayar; jangan ganti kunci yang sah. |