内容分类操作

获取内容分类详情

接口

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

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

代码示例

{% tabs getContentCategoryCurl=”Curl”, getContentCategoryNode=”Node”, getContentCategoryPHP=”PHP” %}

{% content “getContentCategoryCurl” %}

  1. curl -X GET \
  2. -H "Authorization: Bearer cfb5912724dd7ff0b0c17683cc3074bb548bc7f4" \
  3. -H "Content-Type: application/json" \
  4. https://cloud.minapp.com/oserve/v1/content/1/category/1/

{% content “getContentCategoryNode” %}

  1. var request = require("request");
  3. var options = { method: 'GET',
  4.   url: 'https://cloud.minapp.com/oserve/v1/content/1/category/1/',
  5.   headers:
  6.    { 'Content-Type': 'application/json',
  7.      Authorization: 'Bearer cfb5912724dd7ff0b0c17683cc3074bb548bc7f4' } };
  9. request(options, function (error, response, body) {
  10.   if (error) throw new Error(error);
  12.   console.log(body);
  13. });

{% content “getContentCategoryPHP” %}

  1. <?php
  2. $content_group_id = 1; // 内容库的 ID
  3. $category_id = 1; // 内容分类的 ID
  4. $url = "https://cloud.minapp.com/oserve/v1/content/{$content_group_id}/category/{$category_id}/";
  6. $ch = curl_init();
  7. $header = array(
  8.   "Authorization: Bearer {$token}",
  9.   'Content-Type: application/json; charset=utf-8'
  10. );
  12. curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
  13. curl_setopt($ch, CURLOPT_TIMEOUT, 30);
  14. curl_setopt($ch, CURLOPT_URL, $url);
  15. curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
  16. curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  17. curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
  19. $res = curl_exec($ch);
  20. curl_close($ch);

{% endtabs %}

返回示例

  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/oserve/v1/content/:content_group_id/category/

提交参数

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

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

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

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

代码示例

{% tabs getContentCategoryListCurl=”Curl”, getContentCategoryListNode=”Node”, getContentCategoryListPHP=”PHP” %}

{% content “getContentCategoryListCurl” %}

  1. curl -X GET \
  2. -H "Authorization: Bearer cfb5912724dd7ff0b0c17683cc3074bb548bc7f4" \
  3. -H "Content-Type: application/json" \
  4. https://cloud.minapp.com/oserve/v1/content/1/category/

{% content “getContentCategoryListNode” %}

  1. var request = require("request");
  3. var options = { method: 'GET',
  4.   url: 'https://cloud.minapp.com/oserve/v1/content/1/category/',
  5.   headers:
  6.    { 'Content-Type': 'application/json',
  7.      Authorization: 'Bearer cfb5912724dd7ff0b0c17683cc3074bb548bc7f4' } };
  9. request(options, function (error, response, body) {
  10.   if (error) throw new Error(error);
  12.   console.log(body);
  13. });

{% content “getContentCategoryListPHP” %}

  1. <?php
  2. $content_group_id = 1;// 内容库的 ID
  3. $url = "https://cloud.minapp.com/oserve/v1/content/{$content_group_id}/category/";
  5. $ch = curl_init();
  6. $header = array(
  7.   "Authorization: Bearer {$token}",
  8.   'Content-Type: application/json; charset=utf-8'
  9. );
  11. curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
  12. curl_setopt($ch, CURLOPT_TIMEOUT, 30);
  13. curl_setopt($ch, CURLOPT_URL, $url);
  14. curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
  15. curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  16. curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
  18. $res = curl_exec($ch);
  19. curl_close($ch);

{% endtabs %}

返回示例

  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/oserve/v1/content/:content_group_id/category/

参数说明

Content-Type: application/json

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

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

代码示例

{% tabs createContentCategoryCurl=”Curl”, createContentCategoryNode=”Node”, createContentCategoryPHP=”PHP” %}

{% content “createContentCategoryCurl” %}

  1. curl -X POST \
  2. -H "Authorization: Bearer cfb5912724dd7ff0b0c17683cc3074bb548bc7f4" \
  3. -H "Content-Type: application/json" \
  4. -d '{
  5.       "name": "分类1",
  6.     }' \
  7. https://cloud.minapp.com/oserve/v1/content/1/category/

{% content “createContentCategoryNode” %}

  1. var request = require("request");
  3. var options = { method: 'POST',
  4.   url: 'https://cloud.minapp.com/oserve/v1/content/1/category/',
  5.   headers:
  6.    { 'Content-Type': 'application/json',
  7.      Authorization: 'Bearer cfb5912724dd7ff0b0c17683cc3074bb548bc7f4' },
  8.   body: { name: "分类1" },
  9.   json: true
  10. };
  12. request(options, function (error, response, body) {
  13.   if (error) throw new Error(error);
  15.   console.log(body);
  16. });

{% content “createContentCategoryPHP” %}

  1. <?php
  2. $content_group_id = 1;// 内容库的 ID
  3. $param['name'] = 'CreateCategory';
  4. $url = "https://cloud.minapp.com/oserve/v1/content/{$content_group_id}/category/";
  6. $ch = curl_init();
  7. $header = array(
  8.   "Authorization: Bearer {$token}",
  9.   'Content-Type: application/json; charset=utf-8'
  10. );
  12. curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
  13. curl_setopt($ch, CURLOPT_TIMEOUT, 30);
  14. curl_setopt($ch, CURLOPT_URL, $url);
  15. curl_setopt($ch, CURLOPT_POST, true);
  16. curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($param));
  17. curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  18. curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
  20. $res['response'] = curl_exec($ch); // 反馈结果
  21. $res['status_code'] = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 请求状态码
  22. curl_close($ch);

{% endtabs %}

返回示例

  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/oserve/v1/content/:content_group_id/category/:category_id/

代码示例

{% tabs updateContentCategoryCurl=”Curl”, updateContentCategoryNode=”Node”, updateContentCategoryPHP=”PHP” %}

{% content “updateContentCategoryCurl” %}

  1. curl -X PUT \
  2. -H "Authorization: Bearer cfb5912724dd7ff0b0c17683cc3074bb548bc7f4" \
  3. -H "Content-Type: application/json" \
  4. -d '{
  5.       "name": "Test Category"
  6.     }' \
  7. https://cloud.minapp.com/oserve/v1/content/1/category/3/

{% content “updateContentCategoryNode” %}

  1. var request = require("request");
  3. var options = { method: 'PUT',
  4.   url: 'https://cloud.minapp.com/oserve/v1/content/1/category/3/',
  5.   headers:
  6.    { 'Content-Type': 'application/json',
  7.      Authorization: 'Bearer cfb5912724dd7ff0b0c17683cc3074bb548bc7f4' },
  8.   body: { name: 'Test Category' },
  9.   json: true };
  11. request(options, function (error, response, body) {
  12.   if (error) throw new Error(error);
  14.   console.log(body);
  15. });

{% content “updateContentCategoryPHP” %}

  1. <?php
  2. $content_group_id = 1; // 内容库 ID
  3. $category_id = 1;// 内容分类的 ID
  4. $url = "https://cloud.minapp.com/oserve/v1/content/{$content_group_id}/category/{$category_id}/";
  5. $param['name'] = 'updateCategory';
  7. $ch = curl_init();
  8. $header = array(
  9.   "Authorization: Bearer {$token}",
  10.   'Content-Type: application/json; charset=utf-8'
  11. );
  13. curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
  14. curl_setopt($ch, CURLOPT_TIMEOUT, 30);
  15. curl_setopt($ch, CURLOPT_URL, $url);
  16. curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
  17. curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($param));
  18. curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  19. curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
  21. $res['response'] = curl_exec($ch); // 反馈结果
  22. $res['status_code'] = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 请求状态码
  23. curl_close($ch);

{% endtabs %}

返回示例

  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/oserve/v1/content/:content_group_id/category/:category_id/

代码示例

{% tabs deleteContentCategoryCurl=”Curl”, deleteContentCategoryNode=”Node”, deleteContentCategoryPHP=”PHP” %}

{% content “deleteContentCategoryCurl” %}

  1. curl -X DELETE \
  2. -H "Authorization: Bearer cfb5912724dd7ff0b0c17683cc3074bb548bc7f4" \
  3. -H "Content-Type: application/json" \
  4. https://cloud.minapp.com/oserve/v1/content/1/category/1/

{% content “deleteContentCategoryNode” %}

  1. var request = require("request");
  3. var options = { method: 'DELETE',
  4.   url: 'https://cloud.minapp.com/oserve/v1/content/1/category/1/',
  5.   headers:
  6.    { 'Content-Type': 'application/json',
  7.      Authorization: 'Bearer cfb5912724dd7ff0b0c17683cc3074bb548bc7f4' } };
  9. request(options, function (error, response, body) {
  10.   if (error) throw new Error(error);
  12.   console.log(body);
  13. });

{% content “deleteContentCategoryPHP” %}

  1. <?php
  2. $content_group_id = 1; // 内容库 ID
  3. $category_id = 1;// 内容分类的 ID
  4. $url = "https://cloud.minapp.com/oserve/v1/content/{$content_group_id}/category/{$category_id}/";
  6. $ch = curl_init();
  7. $header = array(
  8.   "Authorization: Bearer {$token}",
  9.   'Content-Type: application/json; charset=utf-8'
  10. );
  12. curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
  13. curl_setopt($ch, CURLOPT_TIMEOUT, 30);
  14. curl_setopt($ch, CURLOPT_URL, $url);
  15. curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
  16. curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  17. curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
  19. $res['response'] = curl_exec($ch); // 反馈结果
  20. $res['status_code'] = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 请求状态码
  21. curl_close($ch);

{% endtabs %}

状态码说明

204: 删除成功