创建分类接口[多条]

  • 接口说明： 创建分类接口[多条]
  • 接口地址： /api/categories/batch
  • 请求方式： POST

请求参数

参数名称类型是否必须描述
namestring是分类名称
descriptionstring是分类说明
iconstring否分类图标 URL[可通过上传图片接口上传图标]
sortint否显示顺序
propertyint否属性：0:正常 1:首页展示

请求示例

  1. {
  2.   "data": [
  3.     {
  4.       "type": "categories",
  5.       "attributes": {
  6.         "name": "{{$randomWord}}",
  7.         "description": "{{$randomWords}}",
  8.         "sort": "{{$randomInt}}",
  9.         "icon": "{{$randomAvatarImage}}"
  10.       }
  11.     },
  12.     {
  13.       "type": "categories",
  14.       "attributes": {
  15.         "name": "South Carolina",
  16.         "description": "{{$randomWords}}",
  17.         "sort": "{{$randomInt}}",
  18.         "icon": "{{$randomAvatarImage}}"
  19.       }
  20.     },
  21.     {
  22.       "type": "categories",
  23.       "attributes": {
  24.         "name": "",
  25.         "description": "{{$randomWords}}",
  26.         "sort": "{{$randomInt}}",
  27.         "icon": "{{$randomAvatarImage}}"
  28.       }
  29.     }
  30.   ]
  31. }

返回结果

参数名称类型出现要求描述
dataobject基础数据
typestring数据类型
idint数据 id
attributesobject数据属性
attributes.idint分类 id
attributes.namestring分类名称
attributes.iconstring分类图标 URL
attributes.descriptionstring分类说明
attributes.propertyint属性：0:正常 1:首页展示
attributes.sortint显示顺序
attributes.threadCountint主题总数

返回说明

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

返回示例

  1. {
  2.   "data": [
  3.     {
  4.       "type": "categories",
  5.       "id": "18",
  6.       "attributes": {
  7.         "name": "AGP",
  8.         "description": "connecting deposit hacking Practical Metal Salad",
  9.         "icon": "https://s3.amazonaws.com/uifaces/faces/twitter/imammuht/128.jpg",
  10.         "sort": "184",
  11.         "property": null,
  12.         "thread_count": 0,
  13.         "ip": "127.0.0.1",
  14.         "created_at": "2019-12-02T19:59:10+08:00",
  15.         "updated_at": "2019-12-02T19:59:10+08:00"
  16.       }
  17.     }
  18.   ],
  19.   "meta": [
  20.     {
  21.       "name": "South Carolina",
  22.       "message": {
  23.         "name": ["名称 不能大于 10 个字符。"]
  24.       }
  25.     },
  26.     {
  27.       "name": "",
  28.       "message": {
  29.         "name": ["名称 不能为空。"]
  30.       }
  31.     }
  32.   ]
  33. }