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

Başlarken

SSS ve sorun giderme

Erişiminizi kontrol edin, başarısız bir istek düzeltin veya FlashData kullanımı hakkında bir cevap bul.

Bu sayfada

Ücretsiz bir erişim kontrolü ile başlayın

Görevin başarısız olduğu kontrolini çalıştırın. Mevcut bilgilerini kullanın; bu komutlar bir sorgu göndermez.

CLI erişiminizi kullanın. Bir isim profili için, her komut için --profile NAME. Bu okumalar sorgu kredilerini harcamaz.

Ücretsiz hesap okur
flashdata --version
flashdata doctor --offline
flashdata auth status --json

Ne kontrol etmek için

Kimlik access: ready'ye sahip olmalı ve kaynaklarınızı kapsamalıdır. CLI JSON, kimlik data.identity.identity'da; ayrıca data.accessVerified: true'u gerektirir. accessVerified: false ile başarılı bir komut doğrulanmadı.

CLI profili için, aşağıdaki her komut için --profile NAME. Orijinal --state-dir ve OS kullanıcısını tut. FLASHDATA_API_KEY overrides a save CLI key; SDKs ve MCP ev sahipliği kendi credential konfigürasyonunu kullanır.

Problemi Bul ve düzeltin

Hatanızı oynayan semptomu açın. IDs ve orijinal görevden gelen makblar kullanın.

Komut bulunamadı veya profil eksik

Hiçbir abartılamaz: OS/CPU için salıverin ve dizinini PATH'a ekleyin. Eksik profil: orijinal OS kullanıcı ve eyalet rehberi kullanın. Ayrıca programcı veya konteyner içinde kontrol edin.

Locate the executable
command -v flashdata
flashdata --version
flashdata doctor --offline

401 / 403: anahtar, kapsamı veya expiry

Kurtarılan bir sahibinin anahtarını değiştirmek için, onaylanmış anahtarı gizli bir şekilde yapıştırın. FLASHDATA_API_KEY ayarlandığında, o sırrı iş zamanında güncellemek yerine; başka bir CLI anahtarını tasarruf etmek bunu abartmayacaktır.

  1. 401: Geç kalmış, iptal edilmiş veya yanlış yapılandırılmış anahtar için kontrol edin. 403: talep edilen kaynağı kimlik kapsamıyla karşılaştırın.
  2. REST ve SDKs X-API-Key kullanıyor. Bir MCP OAuth token bir API anahtarı değiştiremez. Geçici erişim için, aşağıdaki iddia kurtarmasını kullanın.
Değiştirin ve kurtarılan bir sahibinin anahtarını doğrulayın
flashdata auth login --replace
flashdata auth status --json

Onaylandı, ancak ajan hala deneme erişimine sahiptir

İddiayı yaratan aynı CLI profilinde eloff bitirmek. Sahibi, tarayıcıda e-posta doğrulama ve onay alır; CLI haçlı alır.

Bit ve doğrulama
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

402: yetersiz kredi

availableCredits ile kaynağınız için mevcut fiyatla karşılaştırın. Sahibin dengesini kullanmak için tükenmiş bir deneme talep edin veya sahibi Billing'u yeniden denemeden önce gözden geçirmesine izin verin.

CLI erişiminizi kullanın. Bir isim profili için, her komut için --profile NAME. Bu okumalar sorgu kredilerini harcamaz.

Ücretsiz hesap okur
flashdata account balance
flashdata account pricing --source google_search --request-count 1

429: Yeniden denemeden önce bekleyin

Retry-After'u başarısız yanıt üzerinde okuyun: saniyeler veya bir HTTP tarihi. O zamana kadar bekleyin ve koncurrency azaltır. Deneme kaydı, 24-hour penceresi için IP'ye üç kayıt sağlar; orijinal profili ve kayıt kanıtı tekrarlayın.

Bu ücretsiz okuma, başlık, statü ve vücut tasarrufu gösterir. Retry-After'u başarısız olan operasyondan kullanın; sorgu, kayıt ve hesap hazır sınırları farklı olabilir.

Cevabı yakalamak · Bash / cURL / jq
# Bash + cURL + jq. This is a free account read.
(
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
curl --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --dump-header diagnostic-headers.txt --output diagnostic.json \
  --write-out '%{http_code}\n' \
  'https://api.flashdata.dev/v2/api-access/identity' > diagnostic-status.txt || exit
printf 'HTTP '; cat diagnostic-status.txt
awk 'tolower($1) == "retry-after:" {
  $1=""; sub(/^ /, ""); sub(/\r$/, ""); print "Retry-After: " $0
}' diagnostic-headers.txt
if jq -e 'type == "object"' diagnostic.json >/dev/null 2>&1; then
  jq '{access, scopes, status, code, requestId}
    | with_entries(select(.value != null))' diagnostic.json
else
  printf 'Non-JSON response saved in diagnostic.json; check the HTTP status.\n'
fi
)
Inspect account kapasite
flashdata account limits

400 / 422: girdileri veya işleme başarısızlıklarını reddetti

Kod, detay ve fieldErrors'dan HTTP hatası. Talep gövdesini düzeltin, request.json olarak tasarruf edin, sonra bunu doğrulayın. Özel bir giriş dosyasında depolama kimliklerini indirin. 422, mevcut bir işin sonucundan gelirse, job.error'u ilk olarak inceleyin.

Ödemeli bir teslim olmadan geçerlilik
flashdata query --input request.json --mode async --dry-run --json

İş bekleyen veya HTTP 200 başarısız bir işle

İşi kayıtlı async makbuzunuz submission.json içinden okuyun. HTTP 200, durum okuma işleminin başarılı olduğunu belirtir; job.status görevin sonucudur (CLI JSON içinde data.status). Batch için queries içindeki ilgili girdiyi submission.json olarak kaydedin.

Devlet veya hataSonraki eylem
pending / processingAynı işte bekleyin; tekrar göndermeyin.
completedFetch ve mevcut sonucu kurtar.
failedİnspect job.error düzeltme çalışması sunmadan önce.
404İş ID'u kontrol edin ve teslim hesabı.
409Sonuçlar hazır değildir. Aynı işi ankete devam edin.
410Stored JSON Sonunda sona ermişti 24 saatler. Kurtarılan kopyasını kullanın; teslim edilen medyanın kendi depolama tutma vardır.
Kurtarılan işi · Bash / jq
# Bash + jq. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)
Yine de koşuştur · geri döndü JOB_ID
flashdata jobs wait JOB_ID
Tamamlanan · yeni bir çıkış dosyası adı kullanın
flashdata jobs result JOB_ID --output recovered-result.json

Timeout / 5xx: Görev kabul edildi mi?

Orijinal koşmak ve Inspect the original run and History Yeniden denemeden önce POST. Onaylanan bir işi yeniden keşfedin. Kabul bilinmiyorsa, koşmak ID ve iletişim desteği tut; IDs'u değiştirmek ve yeniden ortaya çıkarmak suçlamaları tekrarlayabilir.

Inspect ilk · RUN_ID
flashdata runs show RUN_ID
Recover, kabul edilen işleri doğruladı
flashdata runs recover RUN_ID

CLI output_exists: Sonuç dosya zaten var

CLI, --output dosyalarının üzerine yazmaz. Mevcut dosyayı okuyun veya özgün --run-id ve isteği koruyarak yeni çıktı dosyası adı seçin. Bu hatayı aşmak için yeni çalıştırma ID değeri üretmeyin.

Orijinal koşmayı hayal edin
flashdata runs show RUN_ID

Boş arama, eksik komutlar veya hazırlanamaz indirme

Bu komutlar sadece yerel sonuç dosyaları okumuyor, CLI'nun stdout zarfı değil.

MCP araçları eksik veya doğrulama süresiz

Görevi çalıştırın ev sahibine göz atın. Listelenen bir sunucu yapılandırmayı doğrular, çalışma bağlantısı değil. Evlenen OAuth bağlantısı giriş gerektirirse, giriş komutunu çalıştırın ve tam tarayıcı onayını yapın, sonra araç listesini yenileyin.

Açık Açık Açık /mcp İçinde, Codex CLI Bağlantı durumunu ve araçlarını kontrol etmek. Uygulamada, yapılandırılmış sunucuyu kontrol edin ve kurulum değişikliklerden sonra taze bir seansa başlayın.

Check yapılandırma
codex mcp list
Sadece OAuth login gerekli olduğunda gereklidir
codex mcp login flashdata --scopes mcp:research

Skill installed ama ajan onu bulamaz veya kullanamaz

Aynı projeyi kontrol edin, ev sahibi profili ve yerini yüklemek, sonra taze bir ajan seansına başlayın. CLI Görev becerilerine ihtiyaç duyar CLI; flashdata-mcp'in bağlantılı bir bağlantıya ihtiyacı var MCP sunucu. Bir yetenek yükleme bir sunucuya bağlanmaz veya hesap izni verir.

Varsayılan CLI yetenek paketini kontrol edin
flashdata skills verify --agent codex

Sık sık sorulan sorular

Bağlantılı Olmak

Bir AI ajanına ihtiyacım var mı?

Hayır. Kullanımı Kullanın HTTP API, Go/Python/TypeScript SDK, CLI veya konsol doğrudan. MCP ve beceriler ajanlar için ek seçeneklerdir.

Hangi arayüzü seçmeliyim?

Bir kullanım kullanın SDK veya veya veya HTTP API Bir uygulama içinde, CLI terminal görevleri ve MCP Çünkü bir MCP- aciz ev sahibi. Beceriler, CLI görevleri veya MCP araçlarına bağlı olarak talimatlar sağlar; kimlik doğrulamayı değiştirmezler.

Tekrarlanan görevler için kimlikleri yeniden kullanabilir miyim?

Evet. Sahibi erişim kullanın ve aynı korunan CLI profili, runtime secret veya MCP bağlantısını koruyun. API-key erişimi için, recurringAllowed: true'u kontrol edin. Ev sahibiniz veya programcınız programı çalışır.

Yerel ayarlar geri dönüyor mu?

Hayır. API anahtarı veya konsoldaki bağlantıyı geri döndürün. Yerel ayarları sadece yerel kopyaları ortadan kaldırır.

Denemeler ve krediler

Bir ajan FlashData'u işaret etmeden deneyebilir mi?

Evet, CLI veya API'ye geçici erişime uygun olarak. Aynı profili ve kayıt kanıtını yeniden kullanın. Devam eden kullanım, mevcut bir sahibi API anahtarının iddia edilmesine veya mevcut bir sahibine ihtiyaç duyuyor.

Başka bir deneme hibesini eklemeyi iddia ediyor mu?

Kendini talep etmek ekstra deneme kredisi vermiyor. Future istekleri sahibinin hesabı bakiyesini kullanır; kullanılmayan geçici krediler transfer edilmez. Yeni yaratılan bir hesap normal işaret-kredi politikasını takip eder.

Kredi kapakımı kaç tane talep edebilir?

Hesap dengesi ve kaynak fiyatlandırması kontrol edin. İstek notları kaynağa bağlıdır ve karışık kaynak görevleri bir dengeyi paylaşır. YouTube Download, sabit bir istek sayımı değil, indirilen tarafından fiyatlandırılmıştır.

Kaynaklar ve sonuçlar

Neden ajanım aramayabilir ama indirmez?

İndirin sahibi erişim, youtube_download izni ve varış depolama. Geçici denemeler ve mcp:research OAuth İndirme dahil değildir. Yetkili bir sahibi API anahtar bunu kullanarak kullanabilir CLI, HTTP veya veya veya MCP.

Google Search tam web siteleri geri döndürür mi?

Arama sonuçlarını ve alıntıları döndürür. Uygulamanız veya acenteniz seçilen URLs'yu okur.

FlashData video özetleri veya komutlar üretiyor mu?

Metadata'yı ve mevcut satırları alır. Kayıp kuyruklar yaratmaz; modeliniz mevcut sonuçlardan bir özet yazıyor.

Yine de sıkıştı? Asgari bir rapor gönder

HTTP hata bedenini veya CLI JSON hatasını stderr'dan diagnostic.json olarak kurtarın. tanımlayıcılar sadece başarısız bir komuttan sonra. Anahtarları tut, özel sorgu metni ve raporun dışında URLs imzalamıştır. JSON yanıtları için, HTTP statüsü diagnostic-status.txt'dan rapor edin.

Ücretsiz bir CLI erişim kontrolü ele alın · Bash
flashdata auth status --json 2> diagnostic.json
Hata tanımlayıcıları · Bash / jq
# A saved HTTP error or CLI --json error; local files only.
date -u '+%Y-%m-%dT%H:%M:%SZ'
jq '(.error // .) as $e | {
  status: ($e.httpStatus // $e.status),
  code: $e.code,
  requestId: $e.requestId,
  runId: (.runId // $e.runId),
  jobId: $e.remoteId,
  retryAfter: $e.retryAfter
} | with_entries(select(.value != null))' diagnostic.json
Destek raporu
UTC zamanı:
Müşteri + sürüm:
Kaynak + sahne (ya da gönder / anket / getir):
HTTP statüsü + hata kodu:
ID / iş ID / ID:
Submission results: kabul / reddedildi / bilinmeyen
Beklenmiş vs gerçek sonuç: