Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Integrasi

Pilihan otentikasi agen agon

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 menyambungGunaSiapa yang menyimpan buktinya?
Sebuah aplikasi, SDK, CLI atau skrip terjadwalKunci API Pemilik AusToko rahasia server anda atau profil CLI
Alat penelitian Codex atau OpenClawMCP OAuthHost setelah persetujuan browser
Agen agen agen frenia mencoba FlashData tanpa akunKunci Sementara APIAgen 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.

Sumber 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 KelayakanSumber yang ada
Kunci API Pemilik AusSumber-sumber diberikan ke kunci, termasuk youtube_download ketika disetujui.
Kunci Sementara APIDia hanya diberikan sumber-sumber yang memenuhi syarat. Skop baca dari tanggapan identitas saat ini.
MCP OAuthgoogle_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.

Pernah mengimpor sekali
flashdata auth login --profile research

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.

Tetapkan kata kunci · skip jika 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
akun baca 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 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.

PeriksaHasil yang dibutuhkan
Akun yang DiintendedaccountId dan apiKeyId mengidentifikasi akun dan kunci yang ingin anda gunakan.
Akses yang dapat digunakanaccess: ready
Diizinkan oleh:Skop Skop mengandung sumber, seperti google_search. CLI juga mencantumkan sumber yang diizinkan dalam data.identity.permittedSources.
Tugas yang berulangaccountType: 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.

Identitas sementara · lapangan ilustrasi
{
  "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.

Daftar server
codex mcp list

Periksa koneksi dalam OpenClaw

Iaquina Probe server tersimpan, kemudian jalankan pemeriksaan MCP di atas dalam percakapan aktif Anda.

AKAN server
openclaw mcp doctor flashdata --probe

3. 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 KelayakanUntuk tugas berikutnya
Kunci API Pemilik AusGunakan kembali kunci yang disimpan. Ini tidak memiliki langkah penyegaran OAuth; menggantinya jika sudah habis atau dicabut.
MCP OAuthMost 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 APIPenghapusan 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.

Pemeriksaan akses fresh-proses · 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 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.

SambunganDi mana harus membatalkan
MCP OAuthSettings → Connected apps → hibah aplikasi.
Kunci agen API yang diklaim oleh THESettings → Connected apps → Hubungan Agen.
Akun API Kuncinya adalahAPI Keys → kunci yang digunakan oleh integrasi ini.

Fix sebuah pemeriksaan gagal

HasilAksi
accessVerified: falseFasa 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: blockedStop bahkan jika respon HTTP adalah 200. Tinjau kembali akun atau koneksi dalam konsol; jangan anggap tanggapan identitas sebagai izin untuk bertanya.
accountType: temporaryGunakan pengadilan yang memenuhi syarat untuk satu pekerjaan. Klaim klaimnya sebelum penjadwalan; koneksi OAuth baru tidak mengklaim profil ini.
installed: falseSetelah persetujuan pemilik, jalankan flashdata auth finish --wait dengan profil dan direktori negara asli. Kalau begitu ulangi ceknya.
401 / invalid_grantPutuskan kembali kredensial yang telah luput atau dicabut dalam tuan rumah aslinya. Jangan memulai percobaan lain untuk melewatinya.
403 / source_forbiddenPeriksa skop kunci atau daftar sumber OAuth. YouTube Download menggunakan kunci API pemilik.
Akses sah, keseimbangan nolAutentifikasi AVE bekerja. Periksa Billing sebelum pekerjaan berbayar; jangan ganti kunci yang sah.