İçeriğe geç
TR
API anahtarı al
Belgeleri incele

Entegrasyonlar

Ajan kimlik doğrulama seçenekleri

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ıyorsunuzKullanımKim haçlı tutar?
Bir uygulama, SDK, CLI veya planlanan senaryoSahibi API anahtarıSunucunuzun gizli mağazası veya CLI profili
Codex veya OpenClaw araştırma araçlarıMCP OAuthTarayıcı onayından sonra ev sahibi
FlashData'u bir hesap olmadan çalışan bir ajanGeç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.

Hangi 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.

CredentialMevcut 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 OAuthgoogle_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.

Bir kez ithalat bir kez
flashdata auth login --profile research

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.

Anahtarı ayarlayın · zaten yapılandırılırsa atlayı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
Hesap 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'
)

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.

KontrolGerekli sonuç
Intended accountaccountId ve apiKeyId, kullanmak istediğiniz hesabı ve anahtarını tanımlar.
Kullanılabilir erişimaccess: ready
Görev izniKapsam google_search gibi kaynak içerir. CLI Ayrıca izin verilen kaynakları listeler data.identity.permittedSources.
Görevi Yeniden DeğerlendirmeaccountType: 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.

Geçici kimlik · illüstrasyonel alanlar
{
  "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.

Liste sunucuları
codex mcp list

OpenClaw ile bağlantıyı kontrol edin

Daha sonra MCP'u aktif konuşmanızda kontrol edin.

Probe the server
openclaw mcp doctor flashdata --probe

3. 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.

CredentialBir 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 OAuthEv 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.

Taze işlem erişim kontrolü · 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}'
)

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 OAuthSettings → 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: falsefaz 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: blockedHTTP 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: temporaryBir çı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: falseSahibi onayından sonra, flashdata auth finish --wait'u orijinal profil ve eyalet rehberi ile çalıştırın. Sonra kontrolü tekrarlayın.
401 / invalid_grantYeniden, 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_forbiddenAnahtarın kapsamını veya OAuth kaynak listesini kontrol edin. YouTube Download, bir sahibi API anahtar kullanır.
Geçerli erişim, sıfır dengeKimlik doğrulama çalıştı. Billing'u ücretli çalışmadan önce kontrol edin; geçerli bir anahtarı değiştirmeyin.