Print Portal 用户界面和文档中所说的根文件夹是专门配置用于 Print Portal 中的文件夹。REST API 将这些文件夹称为“库”。在请求根文件夹的列表（或枚举根文件夹）时，会看到这一差异。枚举根文件夹（库）的内容时，会列出所有子文件夹及其组成项目（子文件夹或文档）。
REST API 是一种软件体系结构样式，用于获取和处理文本表示形式的 Web 资源内容。Print Portal REST API 使用 JSON 格式来表示数据，因此提交和返回的数据均为 JSON 格式。
本教程中的示例首先会包含使用浏览器处理的 URL 请求和响应。然后会包含以编程方式构造请求的 JavaScript 示例。
对于本教程中的步骤，浏览器与 Print Portal 安装位于相同的客户端上。因此，在 URI 字符串中使用的是“localhost”。
Print Portal 包含称为 Swagger 的 REST API 规范系统。Swagger 可以说是一种 REST API 帮助系统，其中提供每个函数的说明以及用于测试请求的执行环境。
|
|
To view the Swagger user interface, add "swagger" after "BarTender" in the BarTender URI, as follows: http://localhost/BarTender/swagger/ |
Swagger 的内容按两部分呈现。顶端部分包含 API 函数说明以及用于测试 API 请求的功能。底端部分名为“模型”，用于提供每个函数及其要求的说明。例如，如果需要知道 printRequestID 是什么，请转至“模型”部分，然后单击“PrintRequest”以显示自变量及其定义的列表，其中一个自变量是 printRequestID。