如何使用REST API在Ivanti服务请求中上传附件

一、请求体构造（基于multipart/form-data格式） #

Ivanti的附件上传API要求使用multipart/form-data类型的请求体，需包含元数据字段和文件字段两部分：

• 元数据必填字段（需严格匹配Ivanti文档要求，不同版本可能有差异）：
  • objectType：指定附件关联的对象类型，例如Incident（工单）、Change（变更单）等
  • objectId：关联对象的唯一ID，比如具体的工单编号
  • description：附件的描述文本，用于说明附件用途
• 文件字段：承载要上传的文件内容，字段名通常为file（以官方文档为准）

二、Postman中发送请求的具体操作步骤 #

1. 配置请求基础信息：
   • 请求方法选POST，填入Ivanti附件上传的API端点（例如/api/v1/attachments，具体路径以你的Ivanti版本为准）
   • 在Headers中添加有效认证信息，比如Authorization: Bearer <你的访问Token>，确保请求有权限访问API
2. 构建请求体：
   • 切换到Body标签，选择form-data选项（Postman会自动生成正确的Content-Type头，无需手动设置）
   • 依次添加元数据字段：
     • 键输入objectType，类型选Text，值填入对应对象类型（如Incident）
     • 键输入objectId，类型选Text，值填入关联的工单ID
     • 键输入description，类型选Text，值填入附件描述
   • 添加文件字段：
     • 键输入file（或文档指定的字段名），类型切换为File，点击右侧按钮选中本地要上传的文件
     • 如需上传多个文件，重复此步骤添加多个file字段即可
3. 发送请求：点击Send按钮，返回2XX状态码则表示上传成功

注意事项 #

• 元数据字段的名称、值的格式必须与Ivanti官方文档完全匹配，版本不同字段名可能存在差异
• 检查文件大小是否符合Ivanti系统的附件大小限制，超出限制会导致上传失败
• 若使用Session认证，需确保Postman已正确携带有效Cookie

内容的提问来源于stack exchange，提问作者user