# TypeScript & JavaScript SDK

Pasang SDK dan jalankan pencarian dalam Node.js. Pilih TypeScript atau JavaScript; simpan kunci API di server.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/flashdata-typescript
Diulang: 2026-11-04 oleh FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-typescript) — Referensi Sumber dan SDK
- [Dapatkan API key](https://flashdata.dev/app/api-keys) — Membuat kunci pada konsol

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

## Buat permintaan Node.js pertamamu

Pasang paket, atur kunci API Anda dan pilih TypeScript atau JavaScript di bawah. Jalankan kode ini pada server Anda atau dalam skrip lokal.

- [SDK referensi metode](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>

### Pasang SDK

Contoh-contoh ini menggunakan Node.js 22.18+ untuk menjalankan TypeScript secara langsung. Mulai dari folder kosong, atau pilih projek Existing bila Anda memiliki package.json.

#### Proyek baru

##### Instal

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


#### Projek yang telah ada

##### Instal

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


- [Pasang Node.js](https://nodejs.org/en/download)

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

### Otentikasi

Buat kunci dengan izin Google Search atau gunakan kembali kunci yang berwenang. Set FLASHDATA_API_KEY dalam terminal ini menggunakan prompt tersembunyi di bawah ini; lewati ini jika lingkungan anda sudah memasoknya.

Contoh melewati kunci secara eksplisit. Berkas .env tidak dimuat oleh skrip ini. Simpan kunci dalam konfigurasi sisi-server ketika mengintegrasikan ke dalam aplikasi web.

#### Bash

##### Prompt kunci tersembunyi 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

##### Prompt kunci tersembunyi 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
```


- [Daftar](https://flashdata.dev/signup)
- [Buka API Keys](https://flashdata.dev/app/api-keys)
- [Buka Billing](https://flashdata.dev/app/billing)
- [Agen pengaturan percobaan](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md)

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

### Jalankan pencarian

Simpan berkas yang dipilih dan jalankan perintah dalam proyek ini. Masing-masing berlari menyerahkan satu pencarian sampai lima hasil. Kedua berkas dijalankan secara langsung dengan Node.js; tidak ada langkah membangun diperlukan untuk contoh ini.

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

##### Jalankan 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);
```

##### Jalankan

```bash
node quickstart.mjs
```



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

### Periksa hasil

Status pemeriksaan naskah dilakukan dan mencetak judul sumber, URLs dan kredit yang digunakan. Hasil organik kosong valid. Contoh keluaran di bawah ini menggambarkan bentuk; sumber langsung akan bervariasi.

| Ruas | Gunakan |
| --- | --- |
| results[].organic[] | Judul Google Search, link dan snippet. Sumber lain memiliki mereka sendiri diketik payloads. |
| usage.credits | Kredit yang dibebankan untuk permintaan ini; lima hits yang kembali adalah satu permintaan pencarian. |

#### Contoh keluaran

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


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

## Coba sumber data lain

Setiap tab bekerja di TypeScript dan JavaScript. Ganti berkas dari step 3, simpan .mts atau .mjs ekstensi dan jalankan perintah yang sama. Setiap lari adalah permintaan baru dan perlu izin sumber yang ditunjukkan.

### Berita Google

Membutuhkan google_news. Baca entri artikel di results[].news[].

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

Membutuhkan youtube_metadata. Mengembalikan judul, saluran, durasi dan rincian video lainnya.

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

Membutuhkan youtube_transcript. Meminta trek otomatis Inggris yang ada. Teks dalam results[].fullText ketika trek tersedia.

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


- [Semua parameter sumber](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/sources/index.md)

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

## Type- periksa projek TypeScript

Node berjalan contoh ini dengan stripping tipe. Untuk memeriksa tipe tanpa mengirim permintaan, instal TypeScript dan menjalankan kompiler dengan --noEmit:

### Pemeriksaan tipe opsional

```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 dukungan](https://nodejs.org/api/typescript.html)

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

## Apa dukungan SDK

| Gunakan | Metode |
| --- | --- |
| google / youtube | Cari dan ambil data terstruktur dengan sumber pembantu diketik. Gunakan kembali satu klien dalam pelayananmu. |
| youtube.download | Kirim audio atau video ke penyimpanan awan Anda melalui pekerjaan latar belakang. Membutuhkan izin youtube_download dan konfigurasi penyimpanan. |
| jobs / bulk | Simpan tugas yang diajukan IDs dan ambil hasil yang selesai. menunggu di JavaScript; mode: 'async' menyerahkan sebuah pekerjaan latar belakang pelayan. |
| account | Baca akses, keseimbangan, harga, batas dan penggunaan sebelum pekerjaan berulang. |
| respondWith / accept | Pass { respondWith: 'markdown' } sebagai metode argumen kedua untuk Markdown in response.content, atau { accept: 'text/plain' } untuk sebuah string. Benda JSON adalah yang utama. |

- [Unduh contoh](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/examples/youtube_download.mjs)
- [Pengaturan penyimpanan](https://flashdata.dev/id/docs/guides/youtube-download-guide/reference.md)
- [Format respons](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/response-formats.md)

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

## Langkah selanjutnya

- [Menyimpan galat hasil dan penanganan](https://flashdata.dev/id/docs/guides/sdk-operations/reference.md)
- [Pekerjaan dan batch](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/jobs.md)
- [Konfigurasi klien](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/client.md)
- [SDK referensi metode](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/api-reference.md)

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

## Jika satu langkah gagal

| Masalah | Perbaiki |
| --- | --- |
| Paket atau waktu jalan hilang | Periksa titik --version dan pasang @ flashdata-dev/sdk dalam proyek ini. Pertahankan ekstensi .mts atau .mjs yang ditampilkan diatas. |
| 401 / FLASHDATA_API_KEY | Atur kunci yang valid di terminal di mana Anda menjalankan contoh. |
| 403 | Aktifkan Google Search untuk kunci API ini. |
| 402 | Periksa Billing untuk kredit yang tersedia, atau klaim kelelahan agen pengadilan. |
| 429 | Tunggu Retry-After, kemudian kurangi tingkat permintaan Anda. |
| Tenggat waktu atau galat server | Periksa History sebelum mengirim ulang; permintaan pertama mungkin sudah dijalankan. |

- [Meminta riwayat](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [Kesalahan SDK dan pemulihan](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/errors.md)
