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

# 构建 Node REST 冒烟测试应用

> 使用 Node 快速入门示例，了解原始 HTTP 集成和冒烟测试脚本。

如果你想构建尽可能精简的 Node 集成，并清楚查看每个 HTTP 请求，请使用本页。

**目标：** 通过原始 HTTP 验证 Phaseo 健康状态、模型发现和一次生成请求。

**结果：** 获得一个依赖项精简的脚本，可用作部署或集成冒烟测试。

<Prompt description="使用原始 HTTP 为 Phaseo 构建一个 **Node REST 冒烟测试应用**。" icon="terminal" actions={["copy", "cursor"]}>
  {`你正在使用原始 HTTP 构建一个与 Phaseo Gateway 集成的小型 Node.js 应用。

    创建一个基于脚本的应用，要求：
    - 从环境变量读取 PHASEO_API_KEY
    - 调用健康检查和模型发现路由
    - 发送一次文本生成请求
    - 可选择再调用一个功能接口，例如 embeddings

    要求：
    - 使用原始 fetch，不使用 SDK。
    - 保持代码的依赖项精简。
    - 明确列出请求正文，便于审查。
    - 在终端中清晰显示成功和错误信息。
    - 支持快速冒烟模式和更完整的端到端模式。

    交付内容：
    - 脚本
    - package.json 命令
    - 简短的 README
    - .env.example 条目

    验证：
    - 尽可能运行冒烟模式
    - 尽可能运行一次完整请求流程
    - 报告已验证的内容以及仍需确认的假设。`}
</Prompt>

## 示例项目

* GitHub: [examples/gateway-node-quickstart](https://github.com/phaseoteam/Phaseo/tree/main/examples/gateway-node-quickstart)
* 仓库本地路径： `examples/gateway-node-quickstart`

## 此应用的功能

* 调用 `GET /v1/health`
* 调用 `GET /v1/models`
* 测试生成路由，例如 `POST /v1/responses`
* 为冒烟测试、脚本和后端检查提供原始 HTTP 参考

## 适合使用此示例的场景

以下情况可以从此示例开始：

* 你想直接调试原始 API 调用
* 你暂时不需要 SDK 抽象层
* 你正在构建脚本、worker 或 CLI，而不是 Web UI

## 前置条件

* 内置支持`fetch` support
* Phaseo API 密钥

## 运行示例

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

设置：

* `PHASEO_API_KEY`

然后运行以下任一命令：

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

或：

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

## 检查结果

* 冒烟模式会确认 API 可以访问。
* 模型发现至少返回一个模型。
* 完整运行会打印一次成功的生成响应。
* 身份验证失败和非 200 响应会在终端中显示清晰错误。

## 代码检查要点

* 脚本如何加载 `.env.local`
* 如何添加授权标头
* 如何明确构建每个请求
* 如何显示非 200 响应，而不是将其忽略

## 根据需要修改示例

* 精简脚本，只保留服务实际需要的路由
* 多个脚本要复用请求代码时，将其移入一个辅助函数
* 如果原始 HTTP 代码变得重复，可在之后改用 TypeScript SDK

## 相关指南

* [迷你应用起步提示词](./mini-app-starter-prompts.mdx)
* [从免费路由器开始](./free-router-first-deploy.mdx)
* [示例](../guides/examples.mdx)


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