# @api3/api-integrations 中文文档

规范地址：https://npmcn.com/package/%40api3/api-integrations/

版本：22\.9\.0
npm 元数据更新时间：2026-10-30T14:42:38.673Z
中文译文更新时间：2026-11-06T19:52:23.366Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40api3/api-integrations
原文对照：https://npmcn.com/package/%40api3/api-integrations/?lang=original
源码仓库：https://github.com/api3dao/data-feeds

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：291 kB，23 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2023-11-29T17:00:30.726Z
- 最新版本发布：2026-10-30T14:42:38.434Z
- 近 30 天下载量：2426（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：162（近 12 个月 46 个）

## 中文简介

API整合相关业务仓库.

## 安装

```sh
npm install @api3/api-integrations
```

也可以使用：`pnpm add @api3/api-integrations`、`yarn add @api3/api-integrations`、`bun add @api3/api-integrations`

## README

# 辅助整合

管理API整合的仓库.

### api-data.json (英语)

有一个 `api-data.json` 每个 API 提供者的文件 `data/apis/<api-name>/api-data.json` 路径。 此文件包括以下信息.

-   `alias`: API使用的独特别名.
-   `providerType`:说明提供者的类型。 也可以这样 `rest` 或者说 `rpc`。 。 。 .
-   `name`:供公众使用的API名称.
-   `airnode`: API的Airnode地址.
-   `previousAirnodes`: APIs在mnemonic自转前曾经拥有的Airnode地址.
-   `xpub`: 扩展公用钥匙.
-   `supportedFeedsInBatches`: 由 API 支持的分批数据输入器名称,由 OIS 标题所分隔.
-   `deploymentConfigurations`:部署配置描述API的部署.
    -   `signedApi` 是表示API是否有已签名的API部署的旗帜.
    -   `region` 是部署的地区.
    -   `provider` 表示部署地点。 这可能是 `aws` 或者说 `local`。 。 。 .
-   `homepageUrl`:API提供商网站主页URL.
-   `verifiedBaseUrl`: URL 将API提供商的Airnode地址包含在它的TXT记录中,以便人们能够确认Airnode地址.
-   `signedApiUrl`: API提供者部署的已签名API的URL.
-   `productionSignedApiUrls`: API提供者所部署的Airnode feed的已签名APIs的URL将数据推向.
-   `stagingSignedApiUrl`: API 的 URL , API 提供者在其中部署的 Airnode 种子将数据推向其中 .

### 模拟 API

在添加新的 dAPI 之前,我们调查它的理由如下:

-   评估dAPI的数据质量.
-   估计 dAPI 的更新数 .

由于Airnode与伙伴API供应商的回馈每月进行,所以我们维持了每个API的模拟版本,它反映了实际API的管理过程. 模拟API与实际API的主要区别在于,我们自己处理模拟API的Airnode馈送部署,从而在勘测步骤中具有灵活性.

当一个新的dAPI要被添加到市场时,相关的数据feed首先被添加到模拟版的实际API中. 在勘测后,它们就在Airnode饲料重新部署(Fints)之前被添加到实际的API中.

## 常见问题

### @api3/api-integrations 是什么？

API整合相关业务仓库\.

### 如何安装 @api3/api-integrations？

在项目目录运行 npm install @api3/api-integrations，或使用 pnpm add / yarn add / bun add。

### @api3/api-integrations 支持 TypeScript 吗？

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

### @api3/api-integrations 支持 ESM 还是 CommonJS？

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

### @api3/api-integrations 可以商用吗？

@api3/api-integrations 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @api3/api-integrations 的下载量有多少？

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

### @api3/api-integrations 还在维护吗？

最新版本 22\.9\.0 发布于 2026/10/30（8 天前）；至今共发布 162 个版本，其中过去 12 个月发布了 46 个；首次发布于 2023/11/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。