# SDK TypeScript et JavaScript

Installez le SDK et lancez une recherche dans Node.js. Choisissez TypeScript ou JavaScript et conservez les clés API côté serveur.

Référence canonique : https://flashdata.dev/fr/docs/guides/flashdata-typescript
Vérifié le 2026-11-04 par FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-typescript) — Code source et référence du SDK
- [Obtenir une clé API](https://flashdata.dev/app/api-keys) — Créer une clé dans la console

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

## Effectuez votre première requête avec Node.js

Installez le paquet, définissez votre clé API et choisissez TypeScript ou JavaScript ci-dessous. Exécutez ce code sur votre serveur ou dans un script local.

- [Référence des méthodes du 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>

### Installez le SDK

Ces exemples utilisent Node.js 22.18+ pour exécuter TypeScript directement. Commencez dans un dossier vide ou choisissez Projet existant si vous avez déjà un fichier package.json.

#### Nouveau projet

##### Installer

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


#### Projet existant

##### Installer

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


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

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

### Authentifiez-vous

Créez une clé autorisant Google Search ou réutilisez une clé autorisée. Définissez FLASHDATA_API_KEY dans ce terminal avec la saisie masquée ci-dessous ; ignorez cette étape si votre environnement la fournit déjà.

L’exemple transmet explicitement la clé. Ces scripts ne chargent pas les fichiers .env. Pour une application web, conservez la clé dans la configuration côté serveur.

#### Bash

##### Saisie masquée de la clé · 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

##### Saisie masquée de la clé · 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
```


- [S’inscrire](https://flashdata.dev/signup)
- [Ouvrir API Keys](https://flashdata.dev/app/api-keys)
- [Ouvrir la facturation](https://flashdata.dev/app/billing)
- [Configurer un essai d’agent](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md)

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

### Lancez une recherche

Enregistrez le fichier choisi et exécutez sa commande dans ce projet. Chaque exécution soumet une recherche demandant jusqu’à cinq résultats. Les deux fichiers s’exécutent directement avec Node.js, sans étape de compilation pour cet exemple.

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

##### Exécuter · 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);
```

##### Exécuter

```bash
node quickstart.mjs
```



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

### Vérifiez le résultat

Le script vérifie que status vaut done, puis affiche les titres, les URL et les crédits consommés. Un tableau organic vide est valide. La sortie ci-dessous illustre la structure attendue ; les sources réelles varieront.

| Champ | Utilisation |
| --- | --- |
| results[].organic[] | Titres, liens et extraits Google Search. Les autres sources ont leurs propres réponses typées. |
| usage.credits | Crédits facturés pour cette requête ; cinq résultats renvoyés correspondent à une seule requête de recherche. |

#### Exemple de sortie

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


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

## Essayez une autre source de données

Chaque onglet fonctionne en TypeScript et en JavaScript. Remplacez le fichier de l’étape 3, conservez son extension .mts ou .mjs et exécutez la même commande. Chaque exécution est une nouvelle requête et nécessite la permission de source indiquée.

### Google News

Nécessite google_news. Lisez les articles dans 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);
```


### Métadonnées YouTube

Nécessite youtube_metadata. Renvoie les titres, les chaînes, les durées et d’autres informations sur les vidéos.

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


### Transcription YouTube

Nécessite youtube_transcript. Demande une piste automatique anglaise existante. Le texte figure dans results[].fullText lorsque la piste est disponible.

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


- [Tous les paramètres des sources](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/sources/index.md)

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

## Vérifier les types d’un projet TypeScript

Node exécute cet exemple en retirant les annotations de type. Pour vérifier les types sans envoyer de requête, installez TypeScript et lancez le compilateur avec --noEmit :

### Vérification facultative des types

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

- [Prise en charge de TypeScript par Node.js](https://nodejs.org/api/typescript.html)

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

## Fonctionnalités du SDK

| Utilisation | Méthodes |
| --- | --- |
| google / youtube | Recherchez et récupérez des données structurées avec les méthodes typées propres à chaque source. Réutilisez un même client dans votre service. |
| youtube.download | Livrez de l’audio ou de la vidéo dans votre stockage cloud avec une tâche en arrière-plan. La permission youtube_download et une configuration de stockage sont nécessaires. |
| jobs / bulk | Enregistrez les identifiants des tâches soumises et récupérez les résultats terminés. await attend en JavaScript ; mode: 'async' soumet une tâche en arrière-plan côté serveur. |
| account | Consultez l’accès, le solde, les tarifs, les limites et la consommation avant les traitements récurrents. |
| respondWith / accept | Passez { respondWith: 'markdown' } comme deuxième argument de la méthode pour obtenir du Markdown dans response.content, ou { accept: 'text/plain' } pour une chaîne. Par défaut, les réponses sont des objets JSON. |

- [Exemple de téléchargement](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/examples/youtube_download.mjs)
- [Configurer le stockage](https://flashdata.dev/fr/docs/guides/youtube-download-guide/reference.md)
- [Formats de réponse](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/response-formats.md)

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

## Étapes suivantes

- [Enregistrer les résultats et gérer les erreurs](https://flashdata.dev/fr/docs/guides/sdk-operations/reference.md)
- [Tâches et Batch](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/jobs.md)
- [Configuration du client](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/client.md)
- [Référence des méthodes du SDK](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/api-reference.md)

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

## Si une étape échoue

| Problème | Solution |
| --- | --- |
| Paquet ou environnement d’exécution manquant | Vérifiez node --version et installez @flashdata-dev/sdk dans ce projet. Conservez l’extension .mts ou .mjs indiquée ci-dessus. |
| 401 / FLASHDATA_API_KEY | Définissez une clé valide dans le terminal qui exécute l’exemple. |
| 403 | Autorisez Google Search pour cette clé API. |
| 402 | Consultez les crédits disponibles dans la facturation ou rattachez à votre compte un essai d’agent épuisé. |
| 429 | Respectez le délai Retry-After, puis réduisez la fréquence de vos requêtes. |
| Délai dépassé ou erreur serveur | Consultez l’historique avant de renvoyer la requête ; la première peut avoir déjà été exécutée. |

- [Historique des requêtes](https://flashdata.dev/app/jobs)
- [Facturation](https://flashdata.dev/app/billing)
- [Erreurs et récupération avec le SDK](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/errors.md)
