内容操作

    本文档介绍了内容的获取(包括内容表的自定义字段)和内容的创建、编辑和删除等操作

    获取内容详情

    接口

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

    其中 content_group_id 是内容库的 ID, text_id 是内容的 ID

    代码示例

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

    返回示例

    1. {
    2. "id": 1,
    3. "title": "Title",
    4. "content": "",
    5. "cover": null,
    6. "description": "",
    7. "group_id": 1,
    8. "categories": [
    9. {
    10. "id": 1,
    11. "name": "category",
    12. "parent": null
    13. }
    14. ],
    15. "created_at": 1516950540,
    16. "updated_at": 1517800400
    17. }

    返回参数说明

    参数 类型 说明
    id Integer 内容 ID
    title String 内容标题
    content String 详细容
    cover String 封面图
    description String 内容摘要
    group_id Integer 内容库 ID
    categories Object Array 内容所属分类
    created_at Integer 内容创建时间
    updated_at Integer 内容更新时间

    获取内容列表

    接口

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

    提交参数

    内容查询与数据表接口查询保持一致

    代码示例

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

    返回示例

    1. {
    2. "meta": {
    3. "limit": 20,
    4. "next": null,
    5. "offset": 0,
    6. "previous": null,
    7. "total_count": 1
    8. },
    9. "objects": [
    10. {
    11. "id": 1,
    12. "title": "Title",
    13. "content": "",
    14. "cover": null,
    15. "description": "",
    16. "group_id": 1,
    17. "categories": [
    18. {
    19. "id": 1,
    20. "name": "category",
    21. "parent": null
    22. }
    23. ],
    24. "created_at": 1516950540,
    25. "updated_at": 1517800400
    26. }
    27. ]
    28. }

    创建内容

    接口

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

    参数说明

    Content-Type: application/json

    内容表内置字段:

    参数 类型 说明
    id Integer 内容 ID
    title String 内容标题
    content String 详细容
    cover File 封面图
    description String 内容摘要
    group_id Integer 内容库 ID
    categories Integer Array 内容所属分类
    created_at Integer 内容创建时间
    updated_at Integer 内容更新时间

    内容接口参数格式将与数据表接口保持一致

    danger
    字段 group_id 将会被接口自动赋值,所以即使提交的数据中有 group_id 也将会被覆盖

    代码示例

    1. var axios = require('axios').create({
    2. withCredentials: true
    3. })
    4. axios.post('https://cloud.minapp.com/userve/v1/content/1/text/', {"title": "Test Title"}).then(res => {
    5. console.log(res.data)
    6. })

    返回示例

    1. {
    2. "id": 2,
    3. "title": "Test Title",
    4. "group_id": 1,
    5. "categories": [],
    6. "created_at": 1519960085,
    7. "updated_at": 1519960085
    8. }

    info
    在发送创建内容的请求没有对一些内置字段如 content、description 或自定义字段赋值时,接口返回的字段将不会包含这些未被赋值的字段;若希望接口返回所有的字段,可以在创建内容的请求中携带所有的字段;



    接口会根据字段在数据表中定义的类型对提交的数据进行强类型的判断,提交的数据类型不合法,接口将会过滤掉这些字段,只存储合法的字段

    状态码说明

    201: 创建成功

    400: 提交数据为空;提交的数据都不合法

    编辑内容

    接口

    PUT https://cloud.minapp.com/userve/v1/content/:content_group_id/text/:text_id/

    代码示例

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

    返回示例

    1. {
    2. "id": 2,
    3. "title": "Test Title",
    4. "group_id": 1,
    5. "categories": [],
    6. "created_at": 1519960085,
    7. "updated_at": 1519960085
    8. }

    状态码说明

    200: 修改成功

    400: 提交数据为空;提交的数据都不合法

    删除内容

    接口

    DELETE https://cloud.minapp.com/userve/v1/content/:content_group_id/text/:text_id/

    代码示例

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

    状态码说明

    204: 删除成功