Belgeleri incele
Başlarken
Uygulamanız veya acenteniz için bir anahtar oluşturun. Mağazayı kontrol edin ve yaşam döngüsünü yönetin.
Bu sayfada
1. Bir anahtar oluşturun
- Doğrulanmış hesabınıza oturum açın ve API Keys'u açın. Zaten bir tane varsa yetkili bir anahtar kullanın.
- Uygulama ve çevre için onu isimlendirin, bir expiry seçin ve ihtiyaç duyduğu kaynakları seçin. Google Search'u ilk arama örneği için seçin.
- Anahtarı oluşturun ve aşağıda tasarruf edin. Bağımsız ajanlar ve üretim uygulamaları ayrı anahtarlar verin, böylece onları bireysel olarak geri döndürebilirsiniz.
2. Mağaza anahtar anahtarı
FlashData'u çalıştıracağınız yolu seçin. API ve SDK örneklerini oku FLASHDATA_API_KEY; CLI, korunan profilinde anahtarı kurtarabilir. Üretimde, gizli mağazanızdan gelen kimlikleri enjekte edin.
# 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# 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 flashdataSecureKeyGizli bir şekilde anahtarı yapıştırın. Adı bir profil için, burada ve daha sonra komutlarda --profile NAME. Daha önceden yapılandırılmış bir profil, anahtarını değiştirmek için Giriş --replace gerektirir.
flashdata auth login3. Erişimi Verify access
Aynı terminalde veya CLI profilinde ücretsiz kontrol yapın. Anahtarı nasıl depoladığınız sekmeyi kullanın.
FLASHDATA_API_KEY'u aynı terminalde önceki kontrolden kullanın.
(
: "${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'u aynı terminalde önceki kontrolden kullanın.
& {
$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
}CLI erişiminizi kullanın. Bir isim profili için, her komut için --profile NAME. Bu okumalar sorgu kredilerini harcamaz.
flashdata auth statusHesabı ve kaynağı onaylayın
HTTP bu alanları doğrudan döndürür. CLI JSON ile onları data.identity.identity altında bulur ve ayrıca data.accessVerified: true'u gerektirir.
| Kontrol | Beklendi |
|---|---|
| accountId | Bu iş yüküne sahip olan hesap. |
| access | ready |
| scopes | İlk arama için google_search'u içerir. |
| recurringAllowed | true önceden planlanan mal sahibi çalışması. |
Kaynak İzinleri Nasıl Çalışır
Bir anahtar sadece kendi verilen kaynaklarını kullanabilir. Ürün seçimi fiyattan ayrıdır: Hesapdaki her anahtar, satın alınan krediler de dahil olmak üzere paylaşılan dengeden geçirir. Sınırlı bir anahtar kendi harcama kapağına sahip değildir. Future ürünleri açık bir izin verme gerektirir.
Bir anahtar maruz kalırsa
- Aşağıdaki eşleştirme konsol sayfasında hemen ortaya çıkan anahtarı uyandırın ve planlanan çağrıcılarını durdurun.
- Gerekli izinlerle bir yedek oluşturun, her caller'in gizli mağazasında yükler ve yukarıdaki ücretsiz doğrulamayı çalıştırın.
- History ve beklenmedik aktivite için hesap kullanımı. Bir dosyadan bir sır çıkarmak onu geri çevirmez.
Rotate a key
- Gerekli kaynaklarla bir yedek oluşturun ve onu hedef ortamda yükleyin.
- Yukarıdaki ücretsiz doğrulamayı tekrarlayın, sonra uygulama veya programlayıcıyı değiştirin. Her bir çağrıcıyı güncellemek.
- Callers geçiş yaptıktan sonra eski anahtarı Revoke the old key after callers have passed. dizüstü bilgisayarınızdaki gizli bir değişiklik, dağıtılmış hizmetleri güncellemez.
flashdata auth login --replace
flashdata auth statusRevoke access
Zamanlanmış istemcileri durdurun, aşağıdan ilgili anahtarı veya bağlantıyı iptal edin ve eski kimlik bilgisiyle ücretsiz doğrulamayı tekrarlayın. İstek reddedilmelidir. Yerel oturumu kapatmak sunucu erişimini iptal etmez.
| Access type türü | Nereden geri dönecek |
|---|---|
| Sıradan API anahtarı | API Keys |
| Davalı ajan anahtarı | Settings → Connected apps → Agent connections |
| MCP OAuth hibe | Settings → Connected apps |