# @finapi/web-form 中文文档

规范地址：https://npmcn.com/package/%40finapi/web-form/

版本：2\.48\.0
npm 元数据更新时间：2026-06-29T12:48:41.362Z
中文译文更新时间：2026-11-14T18:28:51.200Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40finapi/web-form
原文对照：https://npmcn.com/package/%40finapi/web-form/?lang=original

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

- 包体积（解压后）：76.6 kB，43 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2021-03-29T11:01:27.204Z
- 最新版本发布：2026-06-29T12:48:41.258Z
- 近 30 天下载量：33682（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：68（近 12 个月 11 个）

## 中文简介

整合 FinAPI 网络表格的库

## 安装

```sh
npm install @finapi/web-form
```

也可以使用：`pnpm add @finapi/web-form`、`yarn add @finapi/web-form`、`bun add @finapi/web-form`

## README

# Web 窗体 2.0

我们修改和改进了先前的FinAPI网络表格。 新的 FinAPI 网络 表格2.0为你和你的客户提供了额外的优势.

-   简单整合:减少API端点和简化接口处理 (XS2A, FINTS, Scraper)背景为FINAPI侧,导致 减少努力和测试
-   UX驱动:通过优化UX/UI改进用户体验
-   银行综合搜索
-   综合SCA(Strong客户认证方法)
-   白色标签功能: 使用您的标志、 颜色和字体及更多
-   桌面、平板电脑和智能手机的响应设计
-   易于嵌入网络应用程序和移动应用程序
-   多语种:目前支持的语言有CS,DE,EN,ES,FR,IT,NL等, PL、RO、SK和TR 软件

## 何时使用网络表格?

使用 FinAPI 的网络表格 2. 0 REST 服务,我们的目标是提供最好的 供客户提交最终用户使用的网页表格版本 案例。 但你应该什么时候用网络表格?

作为FINAPI服务的客户,欧洲的监管要求 DSD2条例(德国的ZAG法)可适用于您(请参见您 律师或国家金融监管机构提供咨询.

若无国家财政许可或许可 监管者提供PSD2相关服务 德国监管者要求你 满足不处理银行凭证的最低要求 直接进入银行。 使无PSD2许可证的FINAPI客户能够使用 我们从他们的监管者 来达到这个最低要求 我们创建了FINAPI PSD2网络表格。 请注意,其他管制要求可能适用于: 您的生意和FinAPI不能提供法律建议。 接下来是概述 不同的管理许可及其对使用 finAPI 网络表单 :

| 客户监管许可 | 网络表格 |
| --- | --- |
| 无管理许可 | \- 导入/更新银行连接  
\- 编辑银行连接(编辑最终用户银行证书)  
\- 执行SEPA汇款(SCT)  
\- 执行SEPA直接调试(SDD) |
| 付款(PIS/ZAD) | \- 导入/更新银行连接(批次更新)  
\- 编辑银行连接(编辑最终用户银行证书) |
| 账户信息(AIS/KID) | \- 执行SEPA汇款(SCT)  
\- 执行SEPA即时汇款(SCT-Inst)  
\- 执行SEPA直接调试(SDD) |
| 全面管制(AIS/KID+PIS/ZAD) | \- 可选(任何FinAPI服务不需要网络表格) |

## 更多信息

开发者信息(API参考文献和公共文档)可以是: 在 FinAPI 中发现 [开发者门户](https://www.finapi.io/developer/)。 。 。 .

## 常见问题

### @finapi/web-form 是什么？

整合 FinAPI 网络表格的库

### 如何安装 @finapi/web-form？

在项目目录运行 npm install @finapi/web-form，或使用 pnpm add / yarn add / bun add。

### @finapi/web-form 支持 TypeScript 吗？

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

### @finapi/web-form 支持 ESM 还是 CommonJS？

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

### @finapi/web-form 可以商用吗？

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

### @finapi/web-form 的下载量有多少？

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

### @finapi/web-form 还在维护吗？

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