# TypeScript & JavaScript SDK

Installare lo SDK ed eseguire una ricerca in Node.js. Scegliere TypeScript o JavaScript; tenere le chiavi API sul server.

Riferimento canonico: https://flashdata.dev/it/docs/guides/flashdata-typescript
Recensito: 2026-11-04 da FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-typescript) — Fonte e riferimento SDK
- [Ottieni una chiave API](https://flashdata.dev/app/api-keys) — Creare una chiave nella console

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

## Fai la tua prima richiesta Node.js

Installare il pacchetto, impostare il tasto API e scegliere TypeScript o JavaScript di seguito. Eseguire questo codice sul server o in uno script locale.

- [Riferimento metodo SDK](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>

### Installare la SDK

Questi esempi utilizzano Node.js 22.18+ per eseguire direttamente TypeScript. Avviare in una cartella vuota o selezionare il progetto esistente se si dispone di package.json.

#### Nuovo progetto

##### Installa

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


#### Progetto esistente

##### Installa

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


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

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

### Autentico

Creare una chiave con il permesso di ricerca Google o riutilizzare una chiave autorizzata. Impostare FLASHDATA_API_KEY in questo terminale utilizzando il prompt nascosto qui sotto; saltare questo se il vostro ambiente già lo fornisce.

L'esempio passa esplicitamente la chiave. Un file .env non è caricato da questi script. Mantenere la chiave nella configurazione lato server quando si integra in un'applicazione web.

#### Bash

##### Segnale chiave nascosta · 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

##### Segnale chiave nascosta · 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
```


- [Registrati](https://flashdata.dev/signup)
- [Aprire API Keys](https://flashdata.dev/app/api-keys)
- [Aprire Billing](https://flashdata.dev/app/billing)
- [Configurazione della prova dell'agente](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md)

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

### Esegui una ricerca

Salvare il file selezionato ed eseguire il suo comando in questo progetto. Ogni corsa presenta una ricerca fino a cinque risultati. Entrambi i file vengono eseguiti direttamente con Node.js; non è necessario alcun passo di costruzione per questo esempio.

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

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

##### Esegui

```bash
node quickstart.mjs
```



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

### Verifica il risultato

Lo stato di controllo dello script viene fatto e stampa i titoli di origine, URLs e i crediti utilizzati. I risultati organici vuoti sono validi. L'uscita dell'esempio qui sotto illustra la forma; le fonti dal vivo variano.

| Campo di applicazione | Uso |
| --- | --- |
| results[].organic[] | Google Cerca titoli, link e snippet. Altre fonti hanno i propri carichi di pagamento digitati. |
| usage.credits | Crediti addebitati per questa richiesta; cinque colpi restituiti sono una richiesta di ricerca. |

#### Esempio di output

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


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

## Prova un'altra fonte di dati

Ogni scheda funziona sia in TypeScript che in JavaScript. Sostituire il file dal passo 3, mantenere la sua estensione .mts o .mjs ed eseguire lo stesso comando. Ogni esecuzione è una nuova richiesta e ha bisogno del permesso di origine mostrato.

### Google News

Richiede google_news. Leggi gli articoli 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);
```


### metadati YouTube

Richiede youtube_metadata. Restituisce titoli, canali, durata e altri dettagli video.

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


### Trascrizione di YouTube

Richiede youtube_transcript. Richiede una traccia automatica inglese esistente. Il testo è in results[].fullText quando la traccia è disponibile.

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


- [Tutti i parametri di origine](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/sources/index.md)

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

## Controllare il progetto TypeScript

Node esegue questo esempio spogliando i tipi. Per controllare i tipi senza inviare una richiesta, installare TypeScript ed eseguire il compilatore con --noEmit:

### Controllo del tipo opzionale

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

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

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

## Che cosa supporta SDK

| Uso | Metodi |
| --- | --- |
| google / youtube | Cerca e recupera i dati strutturati con helper di origine digitata. Riutilizzare un cliente nel tuo servizio. |
| youtube.download | Fornisci audio o video al tuo cloud storage attraverso un lavoro di sfondo. Richiede il permesso youtube_download e la configurazione di archiviazione. |
| jobs / bulk | Salvare il lavoro inviato IDs e recuperare i risultati completati. attendere le attese in JavaScript; mode: 'async' presenta un lavoro di sfondo lato server. |
| account | Leggi l'accesso, l'equilibrio, i prezzi, i limiti e l'utilizzo prima del lavoro ricorrente. |
| respondWith / accept | Passare { respondWith: 'markdown' } come secondo argomento del metodo per Markdown in response.content, o { accept: 'text/plain' } per una stringa. Gli oggetti JSON sono di default. |

- [Esempio di download](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/examples/youtube_download.mjs)
- [Configurazione di archiviazione](https://flashdata.dev/it/docs/guides/youtube-download-guide/reference.md)
- [Formati di risposta](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/response-formats.md)

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

## Prossimo passo

- [Salvare i risultati e gestire gli errori](https://flashdata.dev/it/docs/guides/sdk-operations/reference.md)
- [Lavori e lotti](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/jobs.md)
- [Configurazione client](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/client.md)
- [Riferimento metodo SDK](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/api-reference.md)

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

## Se un passo fallisce

| Problematiche | Risolto |
| --- | --- |
| Pacchetto o runtime mancanti | Controllare il nodo --version e installare @flashdata-dev/sdk in questo progetto. Mantenere l'estensione .mts o .mjs sopra indicato. |
| 401 / FLASHDATA_API_KEY | Impostare una chiave valida nel terminale in cui si esegue l'esempio. |
| 403 | Abilitare Google Cercare questo tasto API. |
| 402 | Controllare Billing per i crediti disponibili, o richiedere una prova agente esausta. |
| 429 | Attendere Retry-After, quindi ridurre il tasso di richiesta. |
| Errore di timeout o server | Controllare History prima di effettuare il resending; la prima richiesta potrebbe già essere stata eseguita. |

- [Richiedi la cronologia](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [Errori e ripristino SDK](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/errors.md)
