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

Canonical referans: https://flashdata.dev/tr/docs/guides/flashdata-typescript
İnceleme: 2026-11-04 Tarafından FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-typescript) — Kaynak ve SDK referans
- [API anahtarı alın](https://flashdata.dev/app/api-keys) — Konsolda bir anahtar oluşturun

<a id="application"></a>

## İlk Node.js isteğinizi yapın

Paketi yükleyin, API anahtarını ayarlayın ve TypeScript veya JavaScript'yu aşağıda seçin. Bu kodu sunucunuzda veya yerel bir senaryoda çalıştırın.

- [SDK yöntemi referans](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/api-reference.md)
- [npm](https://www.npmjs.com/package/@flashdata-dev/sdk/v/1.1.0)

<a id="install"></a>

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

#### Yeni Proje Yeni Proje

##### Yükle

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```


#### Mevcut proje

##### Yükle

```bash
npm install --save-exact @flashdata-dev/sdk@1.1.0
```


- [Yükleme yükleme Node.js](https://nodejs.org/en/download)

<a id="key"></a>

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

#### Bash

##### Gizli anahtar · Bash

```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
```


#### PowerShell 7

##### Gizli anahtar · PowerShell

```powershell
# 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
```


- [Kaydol](https://flashdata.dev/signup)
- [API Keys sayfasını aç](https://flashdata.dev/app/api-keys)
- [Açık Billing](https://flashdata.dev/app/billing)
- [Agent deneme kurulumu](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md)

<a id="query"></a>

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

#### TypeScript

##### quickstart.mts

```typescript
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+

```bash
node quickstart.mts
```


#### JavaScript

##### quickstart.mjs

```javascript
import { FlashData } 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 response = await client.google.search({ query: 'battery recycling research', num: 5 });
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);
```

##### Çalıştır

```bash
node quickstart.mjs
```



<a id="result"></a>

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

| Field | Kullanım |
| --- | --- |
| 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. |

#### Örnek çıktı

```text
Battery recycling research https://example.org/recycling
Credits used: 0.02
```


<a id="common-tasks"></a>

## 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

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

#### quickstart.mts / quickstart.mjs

```typescript
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);
```


### YouTube metadata

youtube_metadata'u gerektirir. Başlıklar, kanallar, süresi ve diğer video ayrıntıları.

#### quickstart.mts / quickstart.mjs

```typescript
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.youtube.metadata({
  video_id: 'dQw4w9WgXcQ', include_formats: false,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(response);
```


### YouTube transcript

youtube_transcript'u gerektirir. Mevcut bir İngilizce otomatik pist talep eder. Text, results[].fullText'da, takip mevcut olduğunda.

#### quickstart.mts / quickstart.mjs

```typescript
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.youtube.transcript({
  video_id: 'dQw4w9WgXcQ', language: 'en', auto: true,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(response);
```


- [Tüm kaynak parametreleri](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/sources/index.md)

<a id="typecheck"></a>

## 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

```bash
npm install --save-dev typescript@~5.9.3 @types/node@^22
npx tsc quickstart.mts --module nodenext --target es2022 --strict --noEmit
```

- [Node.js TypeScript desteği](https://nodejs.org/api/typescript.html)

<a id="features"></a>

## SDK ne destekliyor

| Kullanım | Yöntem Yöntemleri |
| --- | --- |
| 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. |

- [Download example örnek](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/examples/youtube_download.mjs)
- [Depolama kurulumu](https://flashdata.dev/tr/docs/guides/youtube-download-guide/reference.md)
- [Yanıt biçimleri](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/response-formats.md)

<a id="next"></a>

## Sonraki adımlar

- [Sonuçlar Kurtarın ve hataları ele alın](https://flashdata.dev/tr/docs/guides/sdk-operations/reference.md)
- [İşler ve toplu toplu](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/jobs.md)
- [Müşteri yapılandırma](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/client.md)
- [SDK yöntemi referans](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/api-reference.md)

<a id="errors"></a>

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

| Problem Sorun Problem Problem Problem | Fix Fix |
| --- | --- |
| 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. |

- [Tarih İstek Tarihi](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [SDK hataları ve kurtarma](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/errors.md)
