# 创建分类接口[单条]

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

# 请求参数

参数名称 类型 是否必须 描述
name string 分类名称
description string 分类说明
icon string 分类图标 URL[可通过上传图片接口上传图标]
sort int 显示顺序
property int 属性:0:正常 1:首页展示

# 请求示例

{
  "data": {
    "type": "categories",
    "attributes": {
      "name": "{{$randomWord}}",
      "description": "{{$randomWords}}",
      "sort": "{{$randomInt}}",
      "icon": "{{$randomAvatarImage}}"
    }
  }
}

# 返回说明

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

# 返回结果

参数名称 类型 出现要求 描述
**data** object 基础数据
type string 数据类型
id int 数据 id
**attributes** object 数据属性
attributes.id int 分类 id
attributes.name string 分类名称
attributes.icon string 分类图标 URL
attributes.description string 分类说明
attributes.property int 属性:0:正常 1:首页展示
attributes.sort int 显示顺序
attributes.threadCount int 主题总数

# 返回示例

{
  "data": {
    "type": "categories",
    "id": "4",
    "attributes": {
      "name": "Latvia",
      "description": "iterate Agent",
      "icon": "",
      "sort": "63",
      "property": null,
      "thread_count": 0,
      "ip": "127.0.0.1",
      "created_at": "2019-12-02T18:08:17+08:00",
      "updated_at": "2019-12-02T18:08:17+08:00"
    }
  }
}