修改主题接口[单条]

  • 接口说明： 修改主题[单条]
  • 接口地址： /api/threads/{id}
  • 请求方式： PATCH

请求参数

参数名称类型是否必须描述示例
isApprovedint否是否合法（0/1/2）
0 不合法
1 正常
2 忽略
isStickybool否是否置顶
isEssencebool否是否加精
isDeletedbool否是否删除（回收站）
isFavoritebool否是否收藏
isSitebool否是否推荐到站点信息页
relationships.categorybool否分类关联关系
messagestring否操作原因
pricefloat否价格（长文、视频 可设置价格）
attachment_pricefloat否附件价格
titlestring否标题（长文时必须）
file_namestring否视频文件名称 视频类型文章必填
file_idstring否视频 file_id 视频类型文章必填
longitudefloat否经度
latitudefloat否纬度
addressstring否经纬度坐标对应的地址（如：广东省深圳市深南大道 10000 号）
locationstring否经纬度坐标对应的位置（如：腾讯大厦）

请求示例

  1. {
  2.   "data": {
  3.     "type": "threads",
  4.     "attributes": {
  5.       "isApproved": false,
  6.       "isSticky": true,
  7.       "isEssence": true,
  8.       "isDeleted": true,
  9.       "price": "2.00",
  10.       "title": "666",
  11.       "file_name": "666",
  12.       "file_id": "666",
  13.       "message": "文章内容不合法"
  14.     },
  15.     "relationships": {
  16.       "category": {
  17.         "data": {
  18.           "type": "categories",
  19.           "id": 4
  20.         }
  21.       }
  22.     }
  23.   }
  24. }

返回说明

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

返回结果

参数名称类型出现要求描述
dataobject基础数据
typestring数据类型
idint数据 id
attributesobject数据属性
titlestring长文主题标题
pricefloat长文主题主题价格
viewCountint查看数
postCountint帖子数
longitudefloat否经度
latitudefloat否纬度
addressstring否经纬度坐标对应的地址（如：广东省深圳市深南大道 10000 号）
locationstring否经纬度坐标对应的位置（如：腾讯大厦）
createdAtdatetime创建时间
updatedAtdatetime修改时间
deletedAtdatetime在回收站时删除时间
isApprovedbool是否合法（0/1/2）
0 不合法
1 正常
2 忽略
isStickybool是否置顶
isEssencebool是否加精
isFavoritebool已收藏时是否收藏
isSitebool是否推荐到站点信息页
isLongArticlebool是否长文
paidbool付费主题是否付费
canViewPostsbool是否有权查看详情
canReplybool是否有权回复
canApprovebool是否有权审核
canStickybool是否有权置顶
canEssencebool是否有权加精
canDeletebool是否有权永久删除
canHidebool是否有权放入回收站
canFavoritebool是否有权收藏
relationshipsobject关联关系
includedobject关联数据

返回示例

  1. {
  2.   "data": {
  3.     "type": "threads",
  4.     "id": "25",
  5.     "attributes": {
  6.       "type": 2,
  7.       "title": "",
  8.       "price": 2,
  9.       "viewCount": 13,
  10.       "postCount": 1,
  11.       "createdAt": "2020-03-10T16:31:54+08:00",
  12.       "updatedAt": "2020-03-10T18:59:28+08:00",
  13.       "isApproved": 1,
  14.       "isSticky": false,
  15.       "isEssence": false,
  16.       "canViewPosts": true,
  17.       "canReply": true,
  18.       "canApprove": true,
  19.       "canSticky": true,
  20.       "canEssence": true,
  21.       "canDelete": true,
  22.       "canHide": true,
  23.       "paid": false,
  24.       "canFavorite": true
  25.     },
  26.     "relationships": {
  27.       "threadVideo": {
  28.         "data": {
  29.           "type": "thread-video",
  30.           "id": "18"
  31.         }
  32.       }
  33.     }
  34.   },
  35.   "included": [
  36.     {
  37.       "type": "thread-video",
  38.       "id": "18",
  39.       "attributes": {
  40.         "id": 18,
  41.         "user_id": 3,
  42.         "thread_id": 25,
  43.         "status": 0,
  44.         "reason": "",
  45.         "file_name": "666",
  46.         "file_id": "666",
  47.         "media_url": "",
  48.         "cover_url": "",
  49.         "updated_at": "2020-03-11T17:22:43+08:00",
  50.         "created_at": "2020-03-10T16:31:54+08:00"
  51.       }
  52.     }
  53.   ]
  54. }