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

# Crie um aplicativo de smoke test REST com Node

> Use o exemplo de início rápido de Node como um passo a passo para uma integração HTTP direta e um script de smoke test.

Use esta página se quiser a menor integração possível com Node e quiser ver cada solicitação HTTP com clareza.

**Objetivo:** Verifique a disponibilidade da Phaseo, a descoberta de modelos e uma solicitação de geração usando HTTP direto.

**Resultado:** Um script com poucas dependências que você pode manter como smoke test de implantação ou integração.

<Prompt description="Crie um **aplicativo de smoke test REST com Node** para a Phaseo usando HTTP direto." icon="terminal" actions={["copy", "cursor"]}>
  {`Você está criando uma pequena integração Node.js com o Phaseo Gateway usando HTTP direto.

    Crie um aplicativo baseado em script que:
    - lê PHASEO_API_KEY do ambiente
    - chama as rotas de disponibilidade e descoberta de modelos
    - faz uma solicitação de geração de texto
    - opcionalmente chama outra área, como embeddings

    Requisitos:
    - Use fetch diretamente, sem SDK.
    - Mantenha o código com poucas dependências.
    - Deixe os corpos das solicitações explícitos e fáceis de auditar.
    - Exiba mensagens claras de sucesso e erro no terminal.
    - Ofereça um modo de smoke test rápido e outro mais completo de ponta a ponta.

    Entregáveis:
    - o script
    - comandos em package.json
    - um README curto
    - uma entrada em .env.example

    Verificação:
    - execute o modo de smoke test, se possível
    - execute um fluxo completo de solicitação, se possível
    - informe o que foi verificado e quaisquer suposições restantes.`}
</Prompt>

## Projeto de exemplo

* GitHub: [examples/gateway-node-quickstart](https://github.com/phaseoteam/Phaseo/tree/main/examples/gateway-node-quickstart)
* Caminho local no repositório: `examples/gateway-node-quickstart`

## O que este aplicativo faz

* chama `GET /v1/health`
* chama `GET /v1/models`
* testa rotas de geração como `POST /v1/responses`
* oferece uma referência de HTTP direto para smoke tests, scripts e verificações de backend

## Quando este exemplo é indicado

Comece por aqui quando:

* quiser depurar chamadas diretas à API
* ainda não quiser abstrações de SDK
* estiver criando um script, worker ou CLI, e não uma interface web

## Pré-requisitos

* Node.js com suporte integrado a `fetch` support
* uma chave de API da Phaseo

## Execute o exemplo

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

Defina:

* `PHASEO_API_KEY`

Depois execute um destes comandos:

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

ou:

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

## Verifique o resultado

* O modo de smoke test confirma que a API está acessível.
* A descoberta de modelos retorna pelo menos um modelo.
* A execução completa exibe uma resposta de geração bem-sucedida.
* Falhas de autenticação e respostas diferentes de 200 geram erros claros no terminal.

## O que observar no código

* como o script carrega `.env.local`
* como o cabeçalho de autorização é anexado
* como cada solicitação é construída explicitamente
* como respostas diferentes de 200 são exibidas em vez de ignoradas

## Como adaptar o exemplo

* reduza o script às rotas que seu serviço realmente precisa
* mova o código compartilhado das solicitações para um helper se vários scripts forem usá-lo
* migre para o SDK de TypeScript depois se o caminho HTTP direto ficar repetitivo

## Guias relacionados

* [Prompts para iniciar um miniaplicativo](./mini-app-starter-prompts.mdx)
* [Comece com o roteador gratuito](./free-router-first-deploy.mdx)
* [Exemplos](../guides/examples.mdx)


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