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

Başlarken

TypeScript & JavaScript SDK

SDK'u yükleyin ve Node.js'da bir arama yapın. TypeScript veya JavaScript'u seçin; sunucuda API anahtarlarını tut.

  1. Yüklemek için SDK

    Bu örnekler kullanır Node.js 22.18+ koşmak TypeScript Doğrudan. Boş bir klasöre başlayın veya package.json'ya sahipseniz mevcut proje seçin.

    Yükle
    npm init -y
    npm install --save-exact @flashdata-dev/[email protected]
  2. Kimlik Doğrulama

    Google Search izni ile anahtar oluşturun veya yetkili bir anahtarı yeniden kullanın. FLASHDATA_API_KEY'u bu terminalde aşağıdaki gizli bir şekilde kullanarak ayarlayın; ortamınızın zaten onu tedarik etmesi durumunda bunu atlayın.

    Örnek anahtarı açıkça alır. Bir .env dosyası bu senaryolar tarafından yüklenmez. Bir web uygulamasına entegre edildiğinde sunucunun yanı sıra konfigürasyonunda anahtarı tutun.

    Gizli anahtar · Bash
    # 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
  3. Arama çalıştırın

    Seçilmiş dosyayı kurtar ve bu projede komutasını çalıştırın. Her run beş sonuç için bir arama gönderir. Her iki dosya doğrudan Node.js ile çalışır; bu örnek için bir adım gerekli değildir.

    quickstart.mts
    import { FlashData, type GoogleSearchParams } from '@flashdata-dev/sdk';
    
    const apiKey = process.env.FLASHDATA_API_KEY;
    if (!apiKey) throw new Error('Set FLASHDATA_API_KEY in the server environment.');
    const client = new FlashData({ apiKey });
    const params: GoogleSearchParams = { num: 5 };
    const response = await client.google.search({ query: 'battery recycling research', ...params });
    if (response.status !== 'done') throw new Error(JSON.stringify(response));
    
    for (const page of response.results) {
      for (const hit of page.organic ?? []) console.log(hit.title, hit.link);
    }
    console.log('Credits used:', response.usage.credits);
    Run ... Node.js 22.18+
    node quickstart.mts
  4. Sonucu kontrol edin

    Senaryo kontrolleri durumu yapılır ve kaynak başlıklarını yazdırır, URLs ve kullanılan kredileri. Boş organik sonuçlar geçerlidir. Aşağıdaki örnek çıktı şekli gösterir; canlı kaynaklar değişir.

    Örnek çıktı
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    results[].organic[]
    Google Search başlıkları, bağlantılar ve parçalar. Diğer kaynaklar kendi tip ödeme yüklerine sahiptir.
    usage.credits
    Bu istek için ücretlendirilir; beş geri dönüş vuruşu bir arama isteğidir.

Başka bir veri kaynağı deneyin

Her sekme hem TypeScript hem de JavaScript'da çalışır. Dosyayı 3 adımından değiştirin, .mts veya .mjs uzantısını tut ve aynı komutu çalıştırın. Her işletme yeni bir istektir ve gösterilen kaynak iznine ihtiyaç duyar.

google_news'u gerektirir. results[].news[] makale girişlerini okuyun.

quickstart.mts / quickstart.mjs
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.google.news({
  query: 'battery recycling', num: 5,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(response);

Bir TypeScript projesi

Node bu örneği striptiz türleri ile çalıştırıyor. Bir istek göndermeden türlerini kontrol etmek için, TypeScript'u yüklemek ve --noEmit ile derleyiciyi çalıştırmak:

Seçmeli tip check
npm install --save-dev typescript@~5.9.3 @types/node@^22
npx tsc quickstart.mts --module nodenext --target es2022 --strict --noEmit

SDK ne destekliyor

google / youtube
Arama ve yapılandırılmış verileri tiplenen kaynak yardımcıları ile alın. Hizmetinizde bir müşteriyi yeniden kullanın.
youtube.download
Bir arka plan işi aracılığıyla bulut depolamanıza ses veya video gönderin. youtube_download izni ve depolama yapılandırması gerekir.
jobs / bulk
Kaydetilmiş iş IDs ve tamamlanmış sonuçları alın. JavaScript; mode: 'async' bir sunucu arka arka plan işi gönderir.
account
Erişim, denge, fiyatlandırma, limitler ve kullanım tekrarlanan çalışmadan önce.
respondWith / accept
{ respondWith: 'markdown' }, bir dize için Markdown için ikinci argüman olarak response.content veya { accept: 'text/plain' } için. JSON nesneler varsayılandir.

Sonraki adımlar

Bir adım başarısız olursa

Paket veya runtime eksik
Bu projede Node --version ve @flashdata-dev/sdk'u kontrol edin. Yukarıda gösterilen .mts veya .mjs uzantısını tut.
401 / FLASHDATA_API_KEY
Örnek çalıştırdığınız terminalde geçerli bir anahtar ayarlayın.
403
Enable Google Search Bunun için API anahtar.
402
Kullanılabilir krediler için Billing bölümünü kontrol edin veya tükenmiş ajan denemesini hesaba bağlayın.
429
Retry-After için bekleyin, sonra istek oranını azaltır.
Zamanout veya sunucu hatası
History'u tekrarlamadan önce kontrol edin; ilk istek zaten çalıştırılabilir.