内容操作（旧）

danger
以下操作不支持内容表自定义字段的获取，建议使用最新内容操作接口。

内容库

获取内容库详情

接口

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

其中 :content_group_id 需替换为你的内容库 ID

代码示例

{% tabs getGroupDetailCurl=”Curl”, getGroupDetailNode=”Node”, getGroupDetailPHP=”PHP” %}

{% content “getGroupDetailCurl” %}

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

{% content “getGroupDetailNode” %}

  1. var request = require('request');
  3. var opt = {
  4.   uri: 'https://cloud.minapp.com/oserve/v1/content/group/15130762111906xx/',  // 15130762111906xx 对应 uri :content_group_id
  5.   method: 'GET',
  6.   headers: {
  7.     Authorization: `Bearer ${token}`
  8.   }
  9. }
  11. request(opt, function(err, res, body) {
  12.     console.log(body)
  13. })

{% content “getGroupDetailPHP” %}

  1. <?php
  2. $content_group_id = 1; // 内容库 ID
  3. $url = "https://cloud.minapp.com/oserve/v1/content/group/{$content_group_id}/";
  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.   "id": 1680,
  3.   "name": "内容库 1"
  4. }

获取内容库列表

接口

GET https://cloud.minapp.com/oserve/v1/content/group/

提交参数

Content-Type: application/json

参数 类型 必填 说明
limit Number N 限制返回资源的个数，默认为 20 条，最大可设置为 1000
offset Number N 设置返回资源的起始偏移值，默认为 0

代码示例

{% tabs getLibraryCurl=”Curl”, getLibraryNode=”Node”, getLibraryPHP=”PHP” %}

{% content “getLibraryCurl”%}

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

{% content “getLibraryNode” %}

  1. var request = require('request');
  3. var opt = {
  4.   uri: 'https://cloud.minapp.com/oserve/v1/content/group/',
  5.   method: 'GET',
  6.   headers: {
  7.     Authorization: `Bearer ${token}`
  8.   },
  9.   qs: {     // query string, 被附加到uri的参数
  10.     offset: 0, // 可选
  11.     limit: 20  // 可选
  12.   }
  13. }
  15. request(opt, function(err, res, body) {
  16.     console.log(body)
  17. })

{% content “getLibraryPHP”%}

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

{% endtabs %}

返回示例

  1. {
  2.   "meta": {
  3.     "limit": 10,
  4.     "next": null,
  5.     "offset": 0,
  6.     "previous": null,
  7.     "total_count": 1
  8.   },
  9.   "objects": [
  10.     {
  11.       "id": 1680,
  12.       "name": "内容库 1"
  13.     }
  14.   ]
  15. }

内容分类

获取内容分类详情

接口

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

其中 :category_id 需替换为你的内容分类 ID

代码示例

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

{% content “getContentCategoryCurl”%}

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

{% content “getContentCategoryNode” %}

  1. var request = require('request');
  3. var opt = {
  4.   uri: 'https://cloud.minapp.com/oserve/v1/content/category/15130762527104xx/',  // 15130762527104xx 对应 uri :category_id
  5.   method: 'GET',
  6.   headers: {
  7.     Authorization: `Bearer ${token}`
  8.   }
  9. }
  11. request(opt, function(err, res, body) {
  12.     console.log(body)
  13. })

{% content “getContentCategoryPHP”%}

  1. <?php
  2. $category_id = 1; // 对应内容分类 ID 
  3. $url = "https://cloud.minapp.com/oserve/v1/content/category/{$category_id}/";
  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.   "id": 1680,
  3.   "name": "分类 1",
  4.   "has_children": true,
  5.   "children": [
  6.     {
  7.       "has_children": false,
  8.       "id": 1708,
  9.       "name": "子分类"
  10.     }
  11.   ]
  12. }

获取内容分类列表

接口

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

参数说明

Content-Type: application/json

参数 类型 必填 说明
content_group_id String Y 内容库的 ID
limit Number N 限制返回资源的个数，默认为 20 条，最大可设置为 1000
offset Number N 设置返回资源的起始偏移值，默认为 0

代码示例

{% tabs getCategoryCurl=”Curl”, getCategoryNode=”Node”, getCategoryPHP=”PHP” %}

{% content “getCategoryCurl” %}

  1. curl -X GET \
  2. -H "Authorization: Bearer token" \
  3. -H "Content-Type: application/json" \
  4. -G \
  5. -d order_by=-created_at \
  6. -d content_group_id=content_group_id \
  7. https://cloud.minapp.com/oserve/v1/content/category/?content_group_id=1

{% content “getCategoryNode” %}

  1. var request = require('request');
  3. var opt = {
  4.   uri: 'https://cloud.minapp.com/oserve/v1/content/category/',
  5.   method: 'GET',
  6.   headers: {
  7.     Authorization: `Bearer ${token}`
  8.   },
  9.   qs: {     // query string, 被附加到uri的参数
  10.     content_group_id: '15130762111906xx'
  11.   }
  12. }
  14. request(opt, function(err, res, body) {
  15.   console.log(body)
  16. })

{% content “getCategoryPHP”%}

  1. <?php
  2. $content_group_id = 1; // 内容库的 ID 
  3. $url = "https://cloud.minapp.com/oserve/v1/content/category/?content_group_id={$content_group_id}";
  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": 10,
  4.     "next": null,
  5.     "offset": 0,
  6.     "previous": null,
  7.     "total_count": 1
  8.   },
  9.   "objects": [
  10.     {
  11.       "id": 1680,
  12.       "name": "分类 1",
  13.       "has_children": true
  14.     }
  15.   ]
  16. }

has_children 表示该分类是否包含子分类，通过获取内容分类详情接口可获得子分类的内容。

内容

获取内容详情

接口

GET https://cloud.minapp.com/oserve/v1/content/detail/:content_id/

其中 :content_id 需替换为你的内容 ID

代码示例

{% tabs getDetailCurl=”Curl”, getDetailNode=”Node”, getDetailPHP=”PHP” %}

{% content “getDetailCurl”%}

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

{% content “getDetailNode”%}

  1. var request = require('request');
  3. var opt = {
  4.   uri: 'https://cloud.minapp.com/oserve/v1/content/detail/15145144732272xx/', // 15145144732272xx 对应 uri :content_id
  5.   method: 'GET',
  6.   headers: {
  7.     Authorization: `Bearer ${token}`
  8.   }
  9. }
  11. request(opt, function(err, res, body) {
  12.     console.log(body)
  13. })

{% content “getDetailPHP”%}

  1. <?php
  2. $content_id = 1; // 内容库的 ID 
  3. $url = "https://cloud.minapp.com/oserve/v1/content/detail/{$content_id}/";
  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.   "content": "<p>\b 该片讲述了伊娅不满父亲的恶作剧</p>",
  3.   "cover": "https://cloud-minapp-1131.cloud.ifanrusercontent.com/1donykIpnuvcRiAX.jpg",
  4.   "created_at": 1504152062,
  5.   "description": "超新约全书摘要",
  6.   "id": 1680,
  7.   "title": "超新约全书"
  8. }

获取内容列表

接口

GET https://cloud.minapp.com/oserve/v1/content/detail/

参数说明

Content-Type: application/json

参数 类型 必填 说明
category_id String Y/N 内容分类的 ID
content_group_id String Y/N 内容库的 ID
order_by String N 对资源进行排序
offset Number N 返回资源的起始偏移值）
limit Number N 返回资源的个数（默认为 20，最大可设置为 1000）

info
注意：发起请求时需要携带 category_id 或 content_group_id 参数。

排序

接口支持以 created_at 字段进行排序，默认是以创建时间的顺序进行排序。

通过提交 order_by 参数来更改接口的排序；

示例：

  1. # 顺序
  2. https://cloud.minapp.com/oserve/v1/content/detail/?order_by=created_at
  4. # 倒序
  5. https://cloud.minapp.com/oserve/v1/content/detail/?order_by=-created_at

代码示例

{% tabs getContentCurl=”Curl”, getContentNode=”Node”, getContentPHP=”PHP” %}

{% content “getContentCurl” %}

  1. curl -X GET \
  2. -H "Authorization: Bearer token" \
  3. -H "Content-Type: application/json" \
  4. -G \
  5. -d order_by=-created_at \
  6. -d category_id=category_id \
  7. https://cloud.minapp.com/oserve/v1/content/detail/?content_group_id=1

{% content “getContentNode” %}

  1. var request = require('request');
  3. var opt = {
  4.   uri: 'https://cloud.minapp.com/oserve/v1/content/detail/',
  5.   method: 'GET',
  6.   headers: {
  7.     Authorization: `Bearer ${token}`  // token的来源请看”授权认证”章节
  8.   },
  9.   qs: {     // query string, 被附加到uri的参数
  10.     content_group_id: '15130762111906xx',
  11.     category_id: '15130762527104xx'
  12.   }
  13. }
  15. request(opt, function(err, res, body) {
  16.     console.log(body)
  17. })

{% content “getContentPHP” %}

  1. <?php
  2. $content_group_id = 1; // 内容库的 ID
  3. $url = "https://cloud.minapp.com/oserve/v1/content/detail/?content_group_id={$content_group_id}";
  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": 10,
  4.     "next": null,
  5.     "offset": 0,
  6.     "previous": null,
  7.     "total_count": 1
  8.   },
  9.   "objects": [
  10.     {
  11.       "content": "<p>\b 该片讲述了伊娅不满父亲的恶作剧</p>",
  12.       "cover": "https://cloud-minapp-1131.cloud.ifanrusercontent.com/1donykIpnuvcRiAX.jpg",
  13.       "created_at": 1504152062,
  14.       "description": "超新约全书摘要",
  15.       "id": 1680,
  16.       "title": "超新约全书"
  17.     }
  18.   ]
  19. }