上传附件接口

  • 接口说明： 上传附件接口
  • 接口地址： /api/attachments
  • 请求方式： POST

请求参数

参数名称类型是否必须描述
filefile是上传的文件
typeint否0 帖子附件 1 帖子图片 2 帖子音频 3 帖子视频 4 消息图片 5 回答图片

请求示例

  1. # form-data
  2. file: 选择的文件
  3. type: 1

返回说明

  • 上传成功， http 状态码： 201
  • 上传失败， http 状态码： 500

返回结果

参数名称类型出现要求描述
dataobject基础数据
typestring数据类型
idint数据 id
attributesobject数据属性
orderint排序
typeint0 帖子附件
1 帖子图片
2 帖子音频
3 帖子视频
4 消息图片
type_idint关联数据 id
isRemotebool是否是远程附件
isApprovedbool是否合法
urlstring附件地址
attachmentstring文件系统生成的名称
extensionstring文件扩展名
fileNamestring文件原名称
filePathstring文件路径
fileSizeint文件大小
fileTypestring文件类型
thumbUrlstringtype=1缩略图地址

返回示例

  1. // 成功示例
  2. {
  3.     "data": {
  4.         "type": "attachments",
  5.         "id": "21",
  6.         "attributes": {
  7.             "order": 0,
  8.             "type": 1,
  9.             "type_id": null,
  10.             "isRemote": false,
  11.             "isApproved": 1,
  12.             "url": "http://discuz.test/storage/attachments/2020/07/30/wJVSfE4xaMkjehM4kDGByh5ZpLOmI51Ta9OaNnhJ.png",
  13.             "attachment": "wJVSfE4xaMkjehM4kDGByh5ZpLOmI51Ta9OaNnhJ.png",
  14.             "extension": "png",
  15.             "fileName": "logomark-orange@2x.png",
  16.             "filePath": "public/attachments/2020/07/30/",
  17.             "fileSize": 10179,
  18.             "fileType": "image/png",
  19.             "thumbUrl": "http://discuz.test/storage/attachments/2020/07/30/wJVSfE4xaMkjehM4kDGByh5ZpLOmI51Ta9OaNnhJ_thumb.png"
  20.         }
  21.     }
  22. }
  24. // 失败示例
  25. {
  26.     "errors": [
  27.         {
  28.             "status": "404",
  29.             "code": "upload_error"
  30.         }
  31.     ]
  32. }