change-pdf-permissions

用途

此技能用于修改 PDF 文件的权限标志（例如是否允许打印、编辑或复制内容），具体流程如下：

1. 接收用户上传的 PDF 文件；
2. 接收用户指定的权限设置（true/false）；
3. 将设置上传至 Solutions API；
4. 轮询任务状态，直到处理完成；
5. 返回更新后 PDF 的下载链接。

凭据要求

API 需要使用 API Key 作为 Bearer Token 认证：

• Authorization: Bearer <API_KEY>

获取 API Key 的方式：

• 注册地址：https://login.cross-service-solutions.com/register
• 或由用户直接提供 API Key。

安全规则： 严禁在日志或输出中显示或记录 API Key。

API 端点

基础 URL：

• https://api.xss-cross-service-solutions.com/solutions/solutions

创建权限修改任务：

• POST /api/75
• 请求格式：multipart/form-data
• 参数说明：

- file — 必填 — PDF 文件（二进制）

- canModify — 必填 — "true" 或 "false"

- canModifyAnnotations — 必填 — "true" 或 "false"

- canPrint — 必填 — "true" 或 "false"

- canPrintHighQuality — 必填 — "true" 或 "false"

- canAssembleDocument — 必填 — "true" 或 "false"

- canFillInForm — 必填 — "true" 或 "false"

- canExtractContent — 必填 — "true" 或 "false"

- canExtractForAccessibility — 必填 — "true" 或 "false"

通过任务 ID 获取结果：

• GET /api/<ID>

任务完成后，响应体包含：

• output.files[] 数组，每个元素为 { name, path }，其中 path 是可下载的文件链接。

输入参数

必填项

• PDF 文件（二进制数据）
• 权限标志（布尔值形式），全部为 API 所需：

- canModify

- canModifyAnnotations

- canPrint

- canPrintHighQuality

- canAssembleDocument

- canFillInForm

- canExtractContent

- canExtractForAccessibility

• API Key（字符串）

可选项

• 无

默认值（推荐配置）

若用户未指定权限，采用保守默认策略：禁止修改和内容提取，但允许打印：

• canModify: false
• canModifyAnnotations: false
• canPrint: true
• canPrintHighQuality: true
• canAssembleDocument: false
• canFillInForm: true （若文档含表单，此为合理默认）
• canExtractContent: false
• canExtractForAccessibility: true （通常对无障碍访问有益）

默认值可根据具体产品策略进行调整。

输出结果

返回结构化结果：

• job_id（数字）— 任务编号
• status（字符串）— 当前状态（如 "done"）
• download_url（字符串）— 任务完成后可用的下载链接
• file_name（字符串）— 输出文件名（可用时）
• permissions（对象）— 反映最终提交的权限设置

示例输出：

{
  "job_id": 7501,
  "status": "done",
  "download_url": "https://.../permissions.pdf",
  "file_name": "permissions.pdf",
  "permissions": {
    "canModify": false,
    "canModifyAnnotations": false,
    "canPrint": true,
    "canPrintHighQuality": true,
    "canAssembleDocument": false,
    "canFillInForm": true,
    "canExtractContent": false,
    "canExtractForAccessibility": true
  }
}