Belgeleri incele
Entegrasyonlar
Bir API anahtarı veya MCP OAuth ile bağlantı kurmak, ücretli bir sorgu olmadan erişimi doğrulamak ve daha sonra görevleri için yeniden kullanın.
Bu sayfada
1. seçin ve bağlantı kurun
Zaten bağlantılı mı? 2'un adımda ücretsiz kontrole gidin. Aksi takdirde, uygulamanızın veya acentenizin ihtiyaç duyduğu erişimi seçin.
| Bağlanıyorsunuz | Kullanım | Kim haçlı tutar? |
|---|---|---|
| Bir uygulama, SDK, CLI veya planlanan senaryo | Sahibi API anahtarı | Sunucunuzun gizli mağazası veya CLI profili |
| Codex veya OpenClaw araştırma araçları | MCP OAuth | Tarayıcı onayından sonra ev sahibi |
| FlashData'u bir hesap olmadan çalışan bir ajan | Geçici API anahtarı | Ajanın kurtarılmış deneme profili, daha sonra sahibine iddia edildikten sonra erişim |
API Keys bölümünde görevin gerektirdiği kaynaklara erişen bir anahtar oluşturun veya mevcut anahtarı kullanın. Anahtarı SDK ortamına sağlayın ya da backend üzerinden X-API-Key başlığıyla gönderin. Adım 2 içindeki Bash ve PowerShell kontrolleri doğrudan API ile çalışır; CLI kurulumu gerekmez.
FlashData OAuth için ev sahibi bir yapılandırın. Hesap sahibi tarayıcıda imza veya imzayı tamamlar ve onay alır; ev sahibi jetleri kurtarır. Bu bağlantı bir CLI anahtarı yüklemez veya bir deneme iddia etmez.
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:researchAnahtarsız bir ajan için, discover, kayıt yapmadan önce mevcut dava uygunluk. Mevcut bir denemeyi ve profilini yeniden kullanın. YouTube Download ve tekrarlanan görevler sahibi erişim gerektirir.
flashdata discover --profile research --jsonHangi kaynaklar bu credential kullanımı olabilir?
Use Use Use X-API-Key Normal için normal HTTP Talepler ve talepler API-key MCP bağlantılar. OAuth ayıcı jetonlar sadece ev sahipliğinde çalışır MCP endpoint. YouTube Download Bir sahibine ihtiyacı var API anahtarı ile anahtar youtube_download ve varış depolama.
| Credential | Mevcut kaynaklar |
|---|---|
| Sahibi API anahtarı | youtube_download dahil anahtara verilen kaynaklar onaylandığında. |
| Geçici API anahtarı | Yalnızca izin verilmiş ve denemeye uygun kaynaklar kullanılabilir. Güncel kimlik yanıtındaki scopes alanını okuyun. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |
CLI'da bir anahtar tasarruf edin
CLI'un zaten eriştiği veya gizli yöneticinizin FLASHDATA_API_KEY'ye sahip olup olmadığını ithal edin. Aksi takdirde, aşağıdaki bir yöntem seçin ve daha sonra komutlar için aynı araştırma profili tut. Kurtarılan CLI anahtarı otomatik olarak SDK veya yerel MCP sunucular için mevcut değildir.
Gizli terminalde anahtarı yapıştırın.
flashdata auth login --profile researchFLASHDATA_KEY_FILE'u mevcut korumalı bir anahtar dosyasının yolunda ayarlayın. Komut bunu stdin aracılığıyla okur ve komuta tartışmalarının anahtarıyla okur.
: "${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. Bağlantıyı doğrulayın
Görevi yapacak çevrede ücretsiz kontrol yapın. CLI ve HTTP checks bir API anahtarı kullanıyor; MCP check, ev sahibinin kendi kurtarılmış bağlantısını kullanıyor.
Bash ve cURL 7.76+'yı gerektirir. Çevrenizin zaten FLASHDATA_API_KEY'u tedarik etmesi durumunda gizli anahtarı yazın. Aynı terminaldeki okuma komutlarını çalıştırın.
# 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'
)FLASHDATA_API_KEY'un zaten ayarlandığı gizli anahtara girin. Aynı terminaldeki okuma komutlarını çalıştırın.
# 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
}OS kullanıcısını, profil ve eyalet dizilerini girişten kullanın. Başka bir profil kullanıyorsanız araştırmayı değiştirin; gerekirse --state-dir PATH ekleyin. FLASHDATA_API_KEY, kurtarılan anahtarın üstüne çıktı. ok: true ve data.accessVerified: true; sonra aşağıdaki kimlik alanlarını inceler.
flashdata auth status --profile research --json --non-interactiveBunu, bağlı ajanınızın taze bir seansına gönderin. google_search'u görev ihtiyaçlarınızla değiştirin. Her iki aracın başarılı olmasını bekleyin; ücretli işten önce fiyat ve dengeyi kontrol edin. Listelenen bir sunucu sadece erişim doğrulamaz.
Mevcut flashdata MCP bağlantısını kullanın.
get_pricing ile {"source":"google_search","request_count":1}'u arayın.
get_balance ile {}'u arayın.
Her iki aramanın başarılı olup olmadığını rapor edin, kaynağın mevcut bir fiyat olup olmadığını,
Ve mevcut kredi dengesi. Sıfır bir denge bir doğrulama başarısızlığı değildir.
Bir arama veya indirme çalıştırmayın, bir deneme oluşturun veya kimlik değiştirir.API-key kimliğini okuyun
HTTP kimlik alanları en üst seviyededir. CLI JSON, data.identity.identity'u okuyun ve data.accessVerified: true'u gerektirir. HTTP 200 veya CLI ok: true tek başına yeterli değildir.
| Kontrol | Gerekli sonuç |
|---|---|
| Intended account | accountId ve apiKeyId, kullanmak istediğiniz hesabı ve anahtarını tanımlar. |
| Kullanılabilir erişim | access: ready |
| Görev izni | Kapsam google_search gibi kaynak içerir. CLI Ayrıca izin verilen kaynakları listeler data.identity.permittedSources. |
| Görevi Yeniden Değerlendirme | accountType: owned · installed: true · recurringAllowed: true |
Aktif bir deneme geçerli bir bağlantıdır
Bir deneme, bir çıkış görevi kontrolünü geçebilirken recurringAllowed Is is is is Is is Is Is is'dir. false. Gerçek kapsamı ve expiry'yi okuyun; mevcut davayı planlamadan önce iddia edin.
{
"accountType": "temporary",
"access": "ready",
"installed": false,
"recurringAllowed": false,
"scopes": [
"google_search"
]
}Codex ile bağlantıyı bulun
Liste yapılandırılmış sunucular, sonra /mcp'u taze bir Codex seansında kullanın. MCP check yukarıda haçlıyı doğrulamak için kontrol edin.
codex mcp listOpenClaw ile bağlantıyı kontrol edin
Daha sonra MCP'u aktif konuşmanızda kontrol edin.
openclaw mcp doctor flashdata --probe3. Daha sonraki görevler için yeniden kullanım erişim
Süreç boyunca özel ve kalıcı olan credential store'ı devam ettirin. Programcınıza izin vermeden önce taze bir süreçte erişim.Recheck access in a fresh process before enable your scheduler.
| Credential | Bir sonraki görev için |
|---|---|
| Sahibi API anahtarı | Kurtarılan anahtarı yeniden kullanın. OAuth yenilenme adımına sahip değil; süresiz veya iptal edilirse değiştirin. |
| MCP OAuth | Ev sahibi bir saat OAuth erişim jetleri geri dönüş jetleri kullanarak. 90-day hibesi sona erdiğinde veya iptal edilir. Her yüklemenin token mağazasına sahiptir; ev sahipleri arasındaki yeni-token dosyaları paylaşmayın. |
| Geçici API anahtarı | Tekrarlanan çalışmadan önce son sahibi iddia etti ve haçlı eloff. Orijinal profili yeniden kullanın; her biri için tekrar kayıt yapmayın. |
Bir CLI görevini planlamadan önce kontrol edin
Bash ve jq'u gerektirir. Görev kaynağına SOURCE'yi ayarlayın. Senaryo, varsayılan olarak araştırma kullanır; FLASHDATA_PROFILE ve FLASHDATA_STATE_DIR'u farklı bir profil veya eyalet rehberi için ayarlar. 0 ile kimlik JSON, sahibinin anahtarı hazır ve bu kaynak için izin verilen anlamına gelir. Planlayıcınız başka bir çıkışta durur. Hiçbir sorgu gönderilemez.
(
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}'
)Eğer erişim hala bir denemedir
Denemeyi tamamlayın ve orijinal profili ile rehberi iddia edin. Sahibi onayı ve haçlı eloff sonra, ücretsiz kontrol erişim ve recurringAllowed: true göstermeli. Devamlı istekler, sahibinin paylaşılan bakiyesini kullanır; kullanılmamış deneme kredileri transfer edilmez. MCP OAuth login ayrı bir bağlantıdır ve bu denemeyi iddia etmez.
Revoke access
Pause ilk önce işleri tekrarladı. Aşağıdaki eşleşen haçlılığı geri alın, ardından yerel erişimi temizlemekten önce taze bir süreçten veya seanstan ücretsiz check'i tekrarlayın. Onaylama başarısızlığı veya yeniden bağlantı isteği; check sırasında yeni bir bağlantı onaylama. Yerel logout tek başına sunucu erişimini geri çevirmez.
| Bağlantı Bağlantısı | Nereden geri dönecek |
|---|---|
| MCP OAuth | Settings → Connected apps → Uygulamanın hibesi. |
| Davalı ajan API anahtarı | Settings → Connected apps → Ajan bağlantıları. |
| Hesap API anahtarı | API Keys → Bu entegrasyon tarafından kullanılan anahtar. |
Başarısız bir çek
| Sonuç Sonuç Sonuç | Action Action Action |
|---|---|
| accessVerified: false | faz ve nextCommand. Beklenmeyen bir profil ok: true'yu anahtardan önce geri döndürebilir. Kurtarılan kayıt veya iddiasını bitirin; aynı profili tut. |
| access: blocked | HTTP cevabı 200 idiyse bile durdurun. Konsoldaki hesabı veya bağlantıyı gözden geçirin; sorguya izin verilen bir kimlik yanıtı tedavi etmeyin. |
| accountType: temporary | Bir çıkış çalışması için uygun denemeyi kullanın. Bunu planlamadan önce talep edin; yeni bir OAuth bağlantısı bu profili iddia etmiyor. |
| installed: false | Sahibi onayından sonra, flashdata auth finish --wait'u orijinal profil ve eyalet rehberi ile çalıştırın. Sonra kontrolü tekrarlayın. |
| 401 / invalid_grant | Yeniden, kendi orijinal ev sahibindeki sınırsız veya geri dönüşlü haçlı haçlı ile bağlantı kurun. Onu atlamak için başka bir deneme başlatmayın. |
| 403 / source_forbidden | Anahtarın kapsamını veya OAuth kaynak listesini kontrol edin. YouTube Download, bir sahibi API anahtar kullanır. |
| Geçerli erişim, sıfır denge | Kimlik doğrulama çalıştı. Billing'u ücretli çalışmadan önce kontrol edin; geçerli bir anahtarı değiştirmeyin. |