获取config

获取配置中设置为到context的所有配置

• url ： app_config

• 请求方法 ： GET

• 参数 ：

• 返回值:

  {
      'code':0,
      'config':{
          'global_value':{ ... },
          'top_ico':{ ... },
          'top_menu':{ ... },
          'common_config':{ ... },
  
          ...
      }
  }

获取文章

• url ： article/<int:article_id>

• 请求方法 ： GET

• 参数 ：

• 返回值:

  {
      'code':0,
      'article': Article , # Article类型，结构参照上面
      'article_meta': ArticleMeta ,
      'category': [ Category, Category ],
      'last_article': Article,
      'next_article': Article,
      'tags': [ Tag, Tag ],
  
  }

获取文章列表

• url ： article_list

• 请求方法 ： GET

• 参数 ：

  • page : 页数，默认：1

  • pre_page : 一页多少文章，默认：7

  • filter_type : 筛选类型，可选项如下：

    • article : 默认，筛选所有文章

    • category : 筛选分类下文章

    • tag : 筛选标签下文章

  • category_id : 筛选分类下文章时指定分类id

  • tag_id : 筛选标签下文章时指定标签id

• 返回值:

  {
      'code':0,
      'article_list': [
              {
                  'article': Article ,
                  'article_meta': ArticleMeta ,
                  'category': [ Category, Category ],
                  'tags': [ Tag, Tag ],
              },
  
              { ... }
       ],
  
      'paginator': {
              'end_index': 4 , # 最大页码
              'current_page_num': 1 ,# 当前页码
      }
  
  }

获取分类

• url ： category/<int:category_id>

• 请求方法 ： GET

• 参数 ：

• 返回值:

  {
      'code':0,
      'category': Category,
      'category_meta': CategoryMeta,
  
  }

获取分类列表

• url ： category_list

• 请求方法 ： GET

• 参数 ：

• 返回值:

  {
      'code':0,
      'category_list': [
  
              {
                  'category': Category,
                  'category_meta': CategoryMeta
              },
  
              {...}
      ]
  
  }

获取分类树

返回按父子结构整理后的分类list

• url ： category_tree

• 请求方法 ： GET

• 参数 ：

• 返回值:

  {
      'code':0,
      'category_tree': [
  
              {
                  'category': Category,
                  'category_meta': CategoryMeta
                  'children':[
  
                      {
                          'category': Category,
                          'category_meta': CategoryMeta
                          'children':[ ... ]
                      },
                  ]
              },
  
              {...}
      ]
  
  }

获取标签

• url ： tag/<int:tag_id>

• 请求方法 ： GET

• 参数 ：

• 返回值:

  {
      'code':0,
      'tag': Tag,
      'tag_meta': TagMeta,
  
  }

获取标签列表

• url ： tag_list

• 请求方法 ： GET

• 参数 ：

• 返回值:

  {
      'code':0,
      'tag_list': [
  
              {
                  'tag': Tag,
                  'tag_meta': TagMeta,
              },
  
              {...}
      ]
  
  }

创建评论

创建评论，需要注意 POST 请求需要在 cookies 里添加 csrftoken

• url ： comment/create

• 请求方法 ： POST

• 参数 ：

  • content : 内容

  • email : 可不填

  • nickname : nickname

  • type : type，可选项如下：

    • 201 : 对文章评论

    • 202 : 对评论评论

  • to_id : 回复的评论id，具体说明参见 Comment 结构说明，以及DeerU源码

  • root_id : 根评论id，具体说明参见 Comment 结构说明，以及DeerU源码

• 返回值:

  {
      'code':0
  }

获取文章的评论列表

返回父子结构的评论list

• url ： comment_list

• 请求方法 ： GET

• 参数 ：

  • article_id : 文章id

• 返回值:

  {
      # 注意：children里不会再有children
  
      'code':0,
      'comment_list': [
  
              {
                  'comment': Comment,
                  'children': [
                          {
                              'comment': Comment,
                              'to_nickname': 'xx'
                          },
  
                          { ... }
                  ],
              },
  
              {...}
      ]
  
  }

获取单页面

• url ： flatpage/<path:url>

• 请求方法 ： GET

• 参数 ：

• 返回值:

  {
      'code':0,
      'flatpage': FlatPage
  
  }