# 扩展 Qlik NPrinting

Qlik NPrinting 公开一组REST API，使您能够从其他软件生成报表。例如，QlikView 用户界面 (On-Demand) 或由第三方开发的软件。

## 用户设置

Qlik NPrinting 管理员可以为 API 用户配置 Windows NTLM 身份验证。该操作可通过在用户配置文件中添加格式为 <域>\<用户名> 的域帐户来完成。Qlik NPrinting 用户只能执行在其配置文件中定义的操作。例如，在应用程序列表中，您仅能看到所连接用户已授权访问的应用程序。如果该用户未获得任何应用程序的授权，您将收到错误消息或看到空的列表。

信息注释

API 用户还可以通过 JWT 身份验证进行设置。但是，JWT 身份验证仅适用于 Qlik NPrinting，不支持 Qlik Sense On-Demand 报告控制。

有关更多信息，请参阅：

* 将 JWT 身份验证与 NPrinting 结合使用，请参阅[JWT 身份验证](https://help.qlik.com/zh-CN/nprinting/February2025/Content/NPrinting/DeployingQVNprinting/JWT-authentication.htm) （仅提供英文版本）。

* 将 JWT 用作 API 身份验证方法，请参阅[如何使用 JWT 身份验证配置和调用 API](https://community.qlik.com/t5/Knowledge/NPrinting-How-to-configure-and-call-APIs-with-JWT-authentication/ta-p/1712523) （仅提供英文版本）。

* 使用 Qlik Sense On-Demand 报告控制，请参阅[按需报告控制](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Visualizations/DashboardBundle/printing-on-demand.htm)。

### 所需角色

在角色管理页面中为 On-Demand 报表设置权限：

* 创建：用户可以请求使用 API 创建报表。

对于所有用户和角色，API 始终处于启用状态。您无法禁用 API。

## 报表设置

要使用 API 运行报表，必须选中启用 On-Demand 复选框。

## API 功能

可用的 API 是用户界面功能的子集，它支持实现 On-Demand 报表。因此，On-Demand 插件使用 API。

借助 Qlik NPrinting API，您可以：

* 获得附带说明的所有可用应用程序的列表。
* 获得附带说明的所有可用报表的列表。
* 获得附带说明的所有可用筛选器的列表。
* 使用 On-Demand 功能。

列表根据用户的角色权限进行过滤。例如，应用程序列表仅包含用户有权查看的应用程序。

## 请求和响应详细信息

除非另行指定，否则所有 API 请求都要求使用内容类型的 application/x-www-form-urlencoded。

所有响应的格式均为 JSON。

所有端点也都支持 HTTP OPTIONS 谓词，并会根据 Qlik NPrinting Server 设置以正确的 CORS 标题（跨域资源共享）进行响应。

## 日期和时间格式

Qlik NPrinting API 支持请求和响应的 ISO 8601 (RfC 3339) 日期和时间格式。

## 针对开发人员的详细文档

提供了针对开发人员的详细 Qlik NPrinting API 文档。

[Qlik NPrinting- API 参考](https://help.qlik.com/zh-CN/nprinting/February2025/Content/NPrinting/Extending/NPrinting-APIs-Reference-Redirect.htm)