如何使用REST API向Yammer上传文件？现有接口报错求解决

旧接口废弃说明 #

• https://www.yammer.com/api/v1/pending_attachments 已全量下线，所有调用该接口的请求会直接返回废弃响应，该接口从设计之初就是附件上传的临时中转逻辑，无恢复可能，所有场景都需要迁移到filesng域名下的统一文件服务接口。

uploadSmallFile 接口返回500的排查方向 #

• 该接口返回500并非通用服务端故障，绝大多数场景是请求不符合服务端校验规则触发的内部异常，按排查优先级逐类核对：
• 必备请求头缺失：接口要求必须携带两个固定请求头，少任意一个都会直接返回500而非常规的401鉴权错误：
  • Authorization: Bearer <有效用户访问令牌>
  • yammer-client-id: <已注册Yammer应用的客户端ID>
• 请求体格式不符合要求：接口仅支持multipart/form-data格式的请求，必须包含三个固定参数：
  • partition：固定值为prod-amber
  • file：原始二进制文件内容，禁止传入base64编码后的字符串
  • checksum：上传文件对应的SHA1十六进制校验值
• 文件大小超出阈值：uploadSmallFile的单文件上传上限为10MB，超过大小的文件会触发接口内部校验逻辑异常，返回500而非标准的413容量超限提示，这类场景需要切换到同服务下的大文件分片上传接口处理。
• 令牌权限不匹配：使用仅具备基础读取权限的用户令牌调用上传接口时，服务端权限校验层抛出的未捕获异常会返回500，不会返回明确的权限不足提示，需要确认当前令牌已开通Yammer企业内容上传的授权范围。

快速定位技巧 #

排查时不要仅依赖500状态码判断问题，需要提取完整的响应体内容——所有接口返回500时，响应体中都会附带具体的错误原因，比如缺少参数、校验值不匹配、权限不足等，对照错误提示调整请求即可快速定位问题。

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