# TypeScript & JavaScript SDK

Installeer de SDK en zoek in Node.js. Kies TypeScript of JavaScript; houd API sleutels op de server.

Canonische referentie: https://flashdata.dev/nl/docs/guides/flashdata-typescript
Beoordeeld: 2026-11-04 door FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-typescript) — Bron- en SDK-referentie
- [Een API-sleutel aanmaken](https://flashdata.dev/app/api-keys) — Een sleutel aanmaken in de console

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

## Maak uw eerste Node.js verzoek

Installeer het pakket, stel uw API sleutel in en kies TypeScript of JavaScript hieronder. Voer deze code uit op uw server of in een lokaal script.

- [Referentie SDK-methode](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>

### Installeer de SDK

Deze voorbeelden gebruiken Node.js 22.18+ om TypeScript direct te draaien. Start in een lege map, of selecteer bestaand project als u package.json heeft.

#### Nieuw project

##### Installeren

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


#### Bestaande projecten

##### Installeren

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


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

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

### Authenticeren

Maak een sleutel aan met Google Search toestemming of hergebruik een geautoriseerde sleutel. Stel FLASHDATA_API_KEY in in deze terminal met behulp van de verborgen prompt hieronder; sla dit over als uw omgeving het al levert.

Het voorbeeld gaat expliciet voorbij aan de sleutel. Een .env-bestand wordt niet door deze scripts geladen. Houd de sleutel in server-side configuratie bij het integreren in een webapplicatie.

#### Bash

##### Verborgen sleutelprompt · 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

##### Verborgen sleutelprompt · 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
```


- [Registreren](https://flashdata.dev/signup)
- [API Keys openen](https://flashdata.dev/app/api-keys)
- [Billing openen](https://flashdata.dev/app/billing)
- [Instellen van het proces van de agent](https://flashdata.dev/nl/docs/guides/agent-onboarding/reference.md)

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

### Een zoekopdracht uitvoeren

Sla het geselecteerde bestand op en voer het commando in dit project uit. Elke run dient een zoekopdracht voor maximaal vijf resultaten. Beide bestanden draaien direct met Node.js; er is geen bouwstap nodig voor dit voorbeeld.

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

##### · Node.js 22.18+ uitvoeren

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

##### Uitvoeren

```bash
node quickstart.mjs
```



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

### Het resultaat controleren

Het script controleert de status is gedaan en drukt brontitels, URLs en gebruikte credits af. Lege biologische resultaten zijn geldig. De voorbeelduitvoer hieronder illustreert de vorm; levende bronnen zullen variëren.

| Veld | Gebruik |
| --- | --- |
| results[].organic[] | Google Search titels, links en knipsels. Andere bronnen hebben hun eigen getypte lading. |
| usage.credits | Credits in rekening gebracht voor dit verzoek; vijf teruggekeerde hits zijn een zoekopdracht. |

#### Voorbeelduitvoer

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


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

## Probeer een andere gegevensbron

Elk tabblad werkt in zowel TypeScript als JavaScript. Vervang het bestand van stap 3, houd de .mts of .mjs extensie en voer hetzelfde commando. Elke run is een nieuw verzoek en heeft de getoonde bron toestemming nodig.

### Google Nieuws

Vereist google_news. Lees artikel in 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

Vereist youtube_metadata. Geeft titels, kanalen, duur en andere videodetails terug.

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

Vereist youtube_transcript. Verzoekt om een bestaand Engels automatisch spoor. Tekst is in results[].fullText wanneer de track beschikbaar is.

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


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

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

## Typ-check een TypeScript-project

Knooppunt draait dit voorbeeld door strippen types. Om types te controleren zonder een verzoek te versturen, installeer TypeScript en voer de compiler uit met --noEmit:

### Facultatief typecontrole

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

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

## Wat de SDK ondersteunt

| Gebruik | Methoden |
| --- | --- |
| google / youtube | Gestructureerde gegevens zoeken en ophalen met getypte bronhelpers. Hergebruik één klant in uw dienst. |
| youtube.download | Lever audio of video naar uw cloudopslag via een achtergrondtaak. Vereist youtube_download toestemming en opslagconfiguratie. |
| jobs / bulk | Opslaan ingezonden taak IDs en afgeronde resultaten ophalen. wacht in JavaScript; mode: 'async' dient een server-side achtergrondtaak in. |
| account | Lees toegang, evenwicht, prijzen, limieten en gebruik voordat u opnieuw werkt. |
| respondWith / accept | Geef { respondWith: 'markdown' } door als tweede argument van de methode voor Markdown in response.content, of { accept: 'text/plain' } voor een string. JSON-objecten zijn standaard. |

- [Voorbeeld downloaden](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/examples/youtube_download.mjs)
- [Opslaginstellingen](https://flashdata.dev/nl/docs/guides/youtube-download-guide/reference.md)
- [Antwoordformaten](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/response-formats.md)

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

## Volgende stappen

- [Resultaten opslaan en fouten verwerken](https://flashdata.dev/nl/docs/guides/sdk-operations/reference.md)
- [Taken en batch](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/jobs.md)
- [Client configuratie](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/client.md)
- [Referentie SDK-methode](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/api-reference.md)

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

## Als een stap mislukt

| Probleem | Repareren |
| --- | --- |
| Pakket of looptijd ontbreekt | Controleer knooppunt --version en installeer @flashdata-dev/sdk in dit project. Houd de .mts of .mjs uitbreiding hierboven weergegeven. |
| 401 / FLASHDATA_API_KEY | Stel een geldige sleutel in in de terminal waar u het voorbeeld uitvoert. |
| 403 | Schakel Google Search in voor deze API sleutel. |
| 402 | Controleer Billing op beschikbare credits, of claim een test met uitgeputte middelen. |
| 429 | Wacht op Retry-After en verlaag dan uw aanvraagsnelheid. |
| Timeout of serverfout | Controleer History alvorens opnieuw te versturen; het eerste verzoek kan al uitgevoerd zijn. |

- [Geschiedenis aanvragen](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [SDK fouten en herstel](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/errors.md)
