> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer une application de test REST Node

> Suivez cet exemple de démarrage Node pour créer une intégration HTTP directe et un script de test rapide.

Utilisez cette page pour créer une intégration Node minimale et voir clairement chaque requête HTTP.

**Objectif:** Vérifier l’état de Phaseo, la découverte des modèles et une requête de génération en HTTP direct.

**Résultat:** Un script avec peu de dépendances que vous pouvez conserver comme test rapide de déploiement ou d’intégration.

<Prompt description="Créez une **application de test rapide REST Node** pour Phaseo avec des requêtes HTTP directes." icon="terminal" actions={["copy", "cursor"]}>
  {`Vous créez une petite intégration Node.js avec Phaseo Gateway en HTTP direct.

    Créez une application basée sur un script qui :
    - lit PHASEO_API_KEY dans l’environnement
    - appelle les routes d’état et de découverte de modèles
    - envoie une requête de génération de texte
    - appelle éventuellement une autre fonctionnalité, comme les embeddings

    Exigences :
    - Utilisez fetch directement, sans SDK.
    - Limitez les dépendances du code.
    - Gardez les charges utiles des requêtes explicites et faciles à vérifier.
    - Affichez clairement les réussites et les erreurs dans le terminal.
    - Prévoyez un mode de test rapide et un mode complet de bout en bout.

    Livrables :
    - le script
    - les commandes package.json
    - un README court
    - une entrée .env.example

    Vérification :
    - exécutez le test rapide si possible
    - exécutez un parcours complet de requête si possible
    - indiquez ce qui a été vérifié et les hypothèses restantes.`}
</Prompt>

## Projet d’exemple

* GitHub : [examples/gateway-node-quickstart](https://github.com/phaseoteam/Phaseo/tree/main/examples/gateway-node-quickstart)
* Chemin du dépôt local : `examples/gateway-node-quickstart`

## Fonctionnement de l’application

* appelle `GET /v1/health`
* appelle `GET /v1/models`
* teste des routes de génération comme `POST /v1/responses`
* fournit une référence HTTP directe pour les tests rapides, les scripts et les vérifications backend

## Quand utiliser cet exemple

Commencez ici si :

* vous voulez déboguer directement les appels API bruts
* vous ne voulez pas encore d’abstraction SDK
* vous créez un script, un worker ou une CLI plutôt qu’une interface Web

## Prérequis

* Node.js avec la prise en charge intégrée de `fetch`
* une clé API Phaseo

## Exécuter l’exemple

```bash theme={null}
cd examples/gateway-node-quickstart
cp .env.example .env.local
```

Définissez :

* `PHASEO_API_KEY`

Exécutez ensuite l’une de ces commandes :

```bash theme={null}
npm run smoke
```

or:

```bash theme={null}
npm run start
```

## Vérifier le résultat

* Le mode de test rapide confirme que l’API est accessible.
* La découverte des modèles renvoie au moins un modèle.
* L’exécution complète affiche une réponse de génération réussie.
* Les erreurs d’authentification et les réponses autres que 200 génèrent des messages clairs dans le terminal.

## Points à examiner dans le code

* comment le script charge `.env.local`
* comment l’en-tête d’autorisation est ajouté
* comment chaque requête est construite explicitement
* comment les réponses autres que 200 sont affichées au lieu d’être ignorées

## Personnaliser l’exemple

* limitez le script aux routes réellement nécessaires à votre service
* regroupez le code de requête partagé dans une fonction si plusieurs scripts en ont besoin
* passez au SDK TypeScript si les requêtes HTTP directes deviennent répétitives

## Guides associés

* [Prompts de démarrage pour mini-application](./mini-app-starter-prompts.mdx)
* [Déployer sur le routeur gratuit](./free-router-first-deploy.mdx)
* [Exemples](../guides/examples.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.