---
title: "SDK"
url: "https://raconte.ai/fr/docs/sdk"
---

### Documentation

[Introduction](/fr/docs)[Démarrer](/fr/docs/getting-started)[Serveur MCP](/fr/docs/mcp)[Webhooks](/fr/docs/webhooks)[API REST](/fr/docs/api)[CLI](/fr/docs/cli)[SDK](/fr/docs/sdk)[Skill agent](/fr/docs/skill)

### Guides

[Configurer le serveur MCP](/fr/guides/mcp-setup)[Utiliser le serveur MCP](/fr/guides/mcp-usage)

[Raconte](/) ⟩ [Documentation](/fr/docs)

# SDK

SDK TypeScript typé pour l'API Raconte : @raconte/node-sdk.

`@raconte/node-sdk` est le SDK TypeScript typé pour l’API Raconte. Il expose la même surface que l’[API REST](/fr/docs/api) (interviews et invitations) sous forme de fonctions typées, générées depuis la spec OpenAPI publique, avec des schémas Zod pour la validation. Il utilise le `fetch` natif et est livré en ESM.

Préférez le [CLI](/fr/docs/cli) pour les scripts et le terminal ; utilisez le SDK dans une application TypeScript ou Node.

## Installation

```
npm install @raconte/node-sdk
```

## Démarrage rapide

Créez une clé d’API d’organisation depuis [Paramètres → API](/settings/api), puis :

```
import { createRaconteClient, interviewsControllerList } from '@raconte/node-sdk'

const client = createRaconteClient({ apiKey: process.env.RACONTE_API_KEY! })

const { data, error } = await interviewsControllerList({ client })
if (error)
  throw new Error(`Échec de la requête : ${JSON.stringify(error)}`)

console.log(data)
```

Chaque fonction du SDK reçoit le client via son option `client` et renvoie `{ data, error, response }` (pas d’exception sur les erreurs HTTP) : vérifiez `error` avant d’utiliser `data`.

`createRaconteClient` accepte `{ apiKey }`. La clé est envoyée en `Authorization: Bearer <clé>`.

## Schémas de validation

Les schémas Zod de chaque requête et réponse sont disponibles via le sous-chemin `/zod` :

```
import { zCreateInterviewSchema } from '@raconte/node-sdk/zod'

const input = zCreateInterviewSchema.parse(payload)
```

## Ce que vous pouvez faire

*   **Interviews** : lister, créer, récupérer, mettre à jour, archiver, restaurer, logs, régénérer intro / premier message.
*   **Invitations** : lister, créer, créer en masse, récupérer, mettre à jour, envoyer, annuler, réactiver, archiver, restaurer, logs, URL audio d’un message.
*   **Voices** : lister le catalogue et obtenir une URL audio d’aperçu (les endpoints publics, sans auth, où l’on choisit un `voiceId`).

Voir la [référence API interactive](/fr/docs/api-reference) pour les schémas complets de requêtes et réponses.

Sommaire

[1\. Installation](#installation)[2\. Démarrage rapide](#démarrage-rapide)[3\. Schémas de validation](#schémas-de-validation)[4\. Ce que vous pouvez faire](#ce-que-vous-pouvez-faire)