@api3/ois

中文文档
3.0.0发布于 2025/07/28MITTypeScriptCommonJS构建来源已验证近 30 天下载 4928

OIS(或作甲骨文集成规格)是一个描述API规格的JSON对象

中文使用文档
文档目录6 节
  1. 安装
  2. 抓到他们了
  3. 使用量
  4. 示例
  5. 开发者文档
  6. 释放

@api3/ois

OIS(或作甲骨文集成规格)是一个描述API规格的JSON对象

您可以在网站上找到 OIS 的文档 文档。 。 。 .

安装

要安装 此软件包 运行 :

pnpm add @api3/ois

或者如果您使用 npm :

npm install @api3/ois --save

抓到他们了

使用被绑定的版本

我们建议使用一个固定版的OIS包,因为包中包含的验证执行OIS 版本到补丁。 固定版本还确保您的项目使用正确的OIS版本,即使有 其他软件包取决于不同的OIS版本.

确保只安装一个"zod"版本

内部,我们使用 佐德语 为OIS计划执行验证和TS打字. 当一个项目使用多个不同的zod版本时,可能会有TS问题.

使用量

OIS软件包定义了验证和TypeScript打字,可用于验证完整的OIS图案的正确性或 只是它的一部分。 例如:

const { oisSchema } = require('@api3/ois');

const possibleOis = {
  // Placeholder values. Refer to the Example section below and the documentation.
  oisFormat: '1.0.0',
  version: '1.2.3',
  title: 'coinlayer',
  apiSpecifications: { ... } // omitted for brevity
  endpoints: [ ... ], // omitted for brevity
};
const result = oisSchema.safeParse(possibleOis);
if (!result.success) {
  throw result.error
} else {
  const validOis = result.data
}

示例

可以找到一个有效的OIS的例子 这里。 。 。 .

开发者文档

释放

GitHub 动作使用 更改/行动。发布 新版本遵循这些步骤:

  1. 假设预期的更改出现在 main ,将 GitHub PR 创建到 release 分支从 main。 。 。 .
  2. 合并 PR 为 release 使用合并执行。 。 。 .
  3. 这个 发布动作工作流程 将创建一个发布 PR.
  4. 审查发行的 PR并合并到 release 使用 壁画和合并。 。 。 .
  5. 这个 发布动作工作流程 将发布 GitHub 发布并发布软件包 npm与出处。 它还将建立一个公关,用于合并 release 树枝返回到 main。 。 。 .
  6. 合并 PR 为 main 从 release 使用合并执行。 。 。 .

请注意,发展可以继续下去 main 换言之, main 无需 保护.

版本与发布记录

@api3/ois 共发布 16 个版本,首次发布于 2022/06/23;过去 12 个月发布了 0 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.0.0latest2025/07/281.3 年前
2.3.22024/02/042 年前
2.3.12023/11/302 年前
2.3.02023/11/272 年前
2.2.12023/10/063 年前
2.2.02023/09/273 年前

关于 @api3/ois 的常见问题

@api3/ois 是什么?

OIS(或作甲骨文集成规格)是一个描述API规格的JSON对象

如何安装 @api3/ois?

在项目目录运行 npm install @api3/ois,或使用 pnpm add / yarn add / bun add。

@api3/ois 支持 TypeScript 吗?

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

@api3/ois 支持 ESM 还是 CommonJS?

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

@api3/ois 可以商用吗?

@api3/ois 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@api3/ois 的下载量有多少?

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

@api3/ois 还在维护吗?

最新版本 3.0.0 发布于 2025/07/28(1.3 年前);至今共发布 16 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/06/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。