change-pdf-permissions

用途

该技能通过以下步骤修改 PDF 文件的权限标志（例如：是否允许打印、编辑或复制）：

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

凭据

API 需要使用 API 密钥作为 Bearer Token：

• Authorization: Bearer

用户获取 API 密钥的方式：

• https://login.cross-service-solutions.com/register
• 或用户可直接提供 API 密钥。

规则：禁止以任何形式回显或记录 API 密钥。

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/

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

• output.files[] 数组，其中每个元素为 { name, path } 结构，path 为可下载的 URL。

输入

必填项

• PDF 文件（二进制）
• 权限标志（类布尔值），API 要求全部提供：
  • canModify
  • canModifyAnnotations
  • canPrint
  • canPrintHighQuality
  • canAssembleDocument
  • canFillInForm
  • canExtractContent
  • canExtractForAccessibility
• API 密钥（字符串）

可选项

• 无

默认值（推荐）

若用户未显式指定权限设置，则采用保守的默认值：禁止修改与内容提取，但允许打印：

• canModify: false
• canModifyAnnotations: false
• canPrint: true
• canPrintHighQuality: true
• canAssembleDocument: false
• canFillInForm: true（若文档含表单，此为合理默认值）
• canExtractContent: false
• canExtractForAccessibility: true（通常建议启用以支持无障碍访问）

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

输出

返回结构化结果：

• job_id（数字）
• status（字符串）
• 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
  }
}