• 内容分类操作
    • 获取内容分类详情
    • 获取内容分类列表
    • 创建内容分类
    • 编辑内容分类
    • 删除内容分类

    内容分类操作

    获取内容分类详情

    接口

    GET https://cloud.minapp.com/userve/v1/content/:content_group_id/category/:category_id/

    其中 content_group_id 是内容库的 ID, category_id 是内容分类的 ID

    代码示例

    1. var axios = require('axios').create({
    2.   withCredentials: true
    3. })
    5. axios.get('https://cloud.minapp.com/userve/v1/content/1/category/1/').then(res => {
    6.   console.log(res.data)
    7. })

    返回示例

    1. {
    2.   "id": 1,
    3.   "name": "category",
    4.   "parent": null,
    5.   "subcategories": [
    6.     {
    7.       "id": 2,
    8.       "name": "subcategory",
    9.       "parent": {
    10.         "id": 1,
    11.         "name": "category"
    12.       },
    13.       "subcategories": [],
    14.       "created_at": 1519901783,
    15.       "updated_at": 1519901783
    16.     }
    17.   ],
    18.   "created_at": 1516963449,
    19.   "updated_at": 1516963449
    20. }

    返回参数说明

    参数 类型 说明
    id Integer 分类 ID
    name String 分类名称
    parent Object 分类的父类
    subcategories Object Array 子类名称
    created_at Integer 分类创建时间
    updated_at Integer 分类更新时间

    获取内容分类列表

    接口

    GET https://cloud.minapp.com/userve/v1/content/:content_group_id/category/

    提交参数

    • parent 内容分类父分类列表查询

      https://cloud.minapp.com/userve/v1/content/:content_group_id/category/?parent__isnull=true

    • name 内容分类名称的等值查询

      https://cloud.minapp.com/userve/v1/content/:content_group_id/category/?name=category

    代码示例

    1. var axios = require('axios').create({
    2.   withCredentials: true
    3. })
    5. axios.get('https://cloud.minapp.com/userve/v1/content/1/category/').then(res => {
    6.   console.log(res.data)
    7. })

    返回示例

    1. {
    2.   "meta": {
    3.     "limit": 20,
    4.     "next": null,
    5.     "offset": 0,
    6.     "previous": null,
    7.     "total_count": 2
    8.   },
    9.   "objects": [
    10.     {
    11.       "id": 1,
    12.       "name": "category",
    13.       "parent": null,
    14.       "subcategories": [
    15.         {
    16.           "id": 2,
    17.           "name": "subcategory",
    18.           "parent": {
    19.             "id": 1,
    20.             "name": "category"
    21.           },
    22.           "subcategories": [],
    23.           "created_at": 1519901783,
    24.           "updated_at": 1519901783
    25.         }
    26.       ],
    27.       "created_at": 1516963449,
    28.       "updated_at": 1516963449
    29.     },
    30.     {
    31.       "id": 2,
    32.       "name": "subcategory",
    33.       "parent": {
    34.         "id": 1516963449144537,
    35.         "name": "category"
    36.       },
    37.       "subcategories": [],
    38.       "created_at": 1519901783,
    39.       "updated_at": 1519901783
    40.     }
    41.   ]
    42. }

    创建内容分类

    接口

    POST https://cloud.minapp.com/userve/v1/content/:content_group_id/category/

    参数说明

    Content-Type: application/json

    参数 类型 必填 说明
    name String Y 分类名称
    parent Integer N 父分类 ID

    warning
    注意：最多只允许三层嵌套分类

    代码示例

    1. var axios = require('axios').create({
    2.   withCredentials: true
    3. })
    5. axios.post('https://cloud.minapp.com/userve/v1/content/1/category/', {"name": "分类1",}).then(res => {
    6.   console.log(res.data)
    7. })

    返回示例

    1. {
    2.   "id": 3,
    3.   "name": "分类1",
    4.   "parent": null,
    5.   "subcategories": [],
    6.   "created_at": 1519910966,
    7.   "updated_at": 1519910966
    8. }

    状态码说明

    201: 创建成功

    400: 同一父分类下的子分类名不能相同；父分类 ID 不合法

    编辑内容分类

    接口

    PUT https://cloud.minapp.com/userve/v1/content/:content_group_id/category/:category_id/

    代码示例

    1. var axios = require('axios').create({
    2.   withCredentials: true
    3. })
    5. axios.put('https://cloud.minapp.com/userve/v1/content/1/category/3/', {"name": "分类1",}).then(res => {
    6.   console.log(res.data)
    7. })

    返回示例

    1. {
    2.   "id": 3,
    3.   "name": "Test Category",
    4.   "parent": null,
    5.   "subcategories": [],
    6.   "created_at": 1519910966,
    7.   "updated_at": 1519910966
    8. }

    状态码说明

    200: 修改成功

    400: 同一父分类下的子分类名不能相同；父分类 ID 不合法

    删除内容分类

    接口

    DELETE https://cloud.minapp.com/userve/v1/content/:content_group_id/category/:category_id/

    代码示例

    1. var axios = require('axios').create({
    2.   withCredentials: true
    3. })
    5. axios.delete('https://cloud.minapp.com/userve/v1/content/1/category/1/').then(res => {
    6.   console.log(res.data)
    7. })

    状态码说明

    204: 删除成功