调用Slack的files.remote.add接口出现invalid_preview_dimensions错误是什么意思？

invalid_preview_dimensions 错误是调用 files.remote.add 接口时，传入的预览图相关参数不符合平台限制导致的，具体触发规则及解决方法如下：

触发原因 #

• 若请求中同时携带了preview_image、preview_width、preview_height三个参数，传入的宽/高数值超出允许范围会触发报错：
  • 单边长度最小不能低于1px，最大不能超过4096px
  • 宽高比需控制在1:20到20:1之间
• 传入的preview_image为base64格式会触发报错：平台不支持base64格式的预览图，仅接受公网可直接访问的资源直链
• 预览图本身属性不符合要求也会触发报错，比如动图帧率超过50fps、单像素位深超过32位等

解决方法 #

• 校验传入的预览图尺寸属性，调整到符合上述限制后再重试
• 若不需要自定义预览图，直接删掉preview_image、preview_width、preview_height三个参数即可，接口会自动生成符合要求的默认预览
• 确认preview_image参数值为不需要鉴权即可直接访问的公网直链，不要传入本地路径、需要登录跳转的资源链接或base64编码内容

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