@antelopejs/interface-api

中文文档
0.3.0发布于 2026/11/05Apache-2.0TypeScriptCommonJS零依赖构建来源已验证近 30 天下载 1.7万

HTTP和WebSocket API的羚羊JS接口:基于装饰器的控制器,路线和参数注入

中文使用文档
文档目录8 节
  1. 它提供的东西
  2. 执行情况
  3. 安装
  4. 快开始
  5. 文档
  6. 兼容性
  7. 捐款
  8. 许可证

@antelopejs/interface-api

npm License Discord Docs

HTTP和WebSocket API的羚羊JS接口. 您使用装饰器声明控制器和路由, 而执行接口的模块为它们服务 .

部分 羚羊JS用于 羚羊JS 隐形物,用于您的 PostgreSQL 、 MongoDB 或 RethinkDB 数据库的开源后台.

它提供的东西

  • Controller 财务报告和审定财务报表 PartialController 基道下的组路线,并有巢 extend。 。 。 .
  • @Get, (中文(简体) ), @Post, (中文(简体) ), @Put, (中文(简体) ), @Delete,以及 @Route 将方法映射到终点. @Prefix, (中文(简体) ), @Postfix,以及 @Monitor 在他们之前或之后运行.
  • @Parameter, (中文(简体) ), @MultiParameter, (中文(简体) ), @JSONBody, (中文(简体) ), @RawBody, (中文(简体) ), @BodyStream, (中文(简体) ), @Context, (中文(简体) ), @Result,以及 @WriteStream 将请求数据注入处理器参数. @Transform 在处理器收到前更改一个值.
  • HTTPResult 设定响应状态、标题和正文。 身体是个 HTTPBody,该字符串或值 JSON.stringify 写作JSON.
  • @WebsocketHandler 财务报告和审定财务报表 @Connection 在同一控制器上处理 WebSocket 连接.

执行情况

模块页:1
@antelopejs/apiHTTP 和 WebSocket 服务器, CORS 设置

安装

将接口添加到宣布路线的模块中 :

pnpm add @antelopejs/interface-api

然后在项目中添加一个执行:

ajs project modules add @antelopejs/api

快开始

import {
  Controller,
  Get,
  HTTPResult,
  JSONBody,
  Parameter,
  Post,
} from "@antelopejs/interface-api";

export class BookController extends Controller("/books") {
  @Get(":id")
  async getBook(@Parameter("id") id: string) {
    return new HTTPResult(200, { id });
  }

  @Post("")
  async createBook(@JSONBody() body: { title: string }) {
    return new HTTPResult(201, body);
  }
}

装饰者在 JavaScript 定义类时对路由进行注册. @antelopejs/api 服务 GET /books/:id 财务报告和审定财务报表 POST /books。 。 。 .

文档

兼容性

模块宣布此对等依赖 :

软件包支助测试过
@antelopejs/interface-core>=0.4.0 <1.0.00.4.0

捐款

读取 捐款额 在你打开拉动请求之前。 当地检查为:

pnpm install
pnpm run checks

许可证

阿帕奇 - 2.0

版本与发布记录

@antelopejs/interface-api 共发布 18 个版本,首次发布于 2026/03/23;过去 12 个月发布了 18 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.3.0latest2026/11/051 天前
0.2.02026/11/051 天前
0.1.02026/10/298 天前
0.0.162026/10/2314 天前
0.0.152026/10/1720 天前
0.0.142026/09/241 个月前

关于 @antelopejs/interface-api 的常见问题

@antelopejs/interface-api 是什么?

HTTP和WebSocket API的羚羊JS接口:基于装饰器的控制器,路线和参数注入

如何安装 @antelopejs/interface-api?

在项目目录运行 npm install @antelopejs/interface-api,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@antelopejs/interface-core(>=0.4.0 <1.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@antelopejs/interface-api 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@antelopejs/interface-api 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@antelopejs/interface-api 可以商用吗?

@antelopejs/interface-api 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@antelopejs/interface-api 的下载量有多少?

根据 npm 官方下载统计,@antelopejs/interface-api 在 2026/10/06 – 2026/11/04 这 30 天内被下载 16,977 次,日均约 566 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@antelopejs/interface-api 还在维护吗?

最新版本 0.3.0 发布于 2026/11/05(1 天前);至今共发布 18 个版本,其中过去 12 个月发布了 18 个;首次发布于 2026/03/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。