2020-web前端-今日头条发布管理系统-使用vue来完成-接口文档-Day01

梦里梦外; 2022-12-13 01:18 163阅读 0赞

# 今日头条发发布管理系统 #

# 门户 #

## 查询所有已实现接口 ##

### 基本信息 ###

**Path：** /mp/

**Method：** GET

**接口描述：**

线上接口地址 [http://ttapi.research.itcast.cn/mp/][http_ttapi.research.itcast.cn_mp]  
返回已上线接口地址，形如：

{
        "user.Authorization": "/v1_0/authorizations",
        "user.Captcha": "/v1_0/captchas/<mobile:mobile>",
        "user.SMSVerificationCode": "/v1_0/sms/codes/<mobile:mobile>"
    }

键为接口名称  
值为接口路径

### 请求参数 ###

### 返回数据 ###

# 用户 #

## 刷新用户 token ##

### 基本信息 ###

**Path：** /mp/v1\_0/authorizations

**Method：** PUT

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/authorizations

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
2. 400 请求参数错误  
3.  403 refresh\_token未携带或已过期  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>参数值</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Content-Type</td> 
   <td>application/json</td> 
   <td>是</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>Authorization</td> 
   <td></td> 
   <td>是</td> 
   <td>Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NDMyODQzNjYsInVzZXJfaWQiOjF9.mLYitrKsn4E4KdQd0CNPugKrH8uQmXEQTlG_JutC8jU</td> 
   <td>refresh_token</td> 
  </tr> 
 </tbody> 
</table>

**Body**

### 返回数据 ###

## 用户认证（登录） ##

### 基本信息 ###

**Path：** /mp/v1\_0/authorizations

**Method：** POST

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/authorizations

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
2. 400 请求参数错误  
        包括：参数缺失、手机号格式不正确、验证码失效等  
3.  403 用户非实名认证用户，无权限登录  
4. 507 服务器数据库异常

### 3. token说明 ###

1.  `token`用于访问需要身份认证的普通接口，有效期2小时
2.  `refresh_token` 用于在token过期后，获取新的用户token，有效期14天

请求方法：GET

请求参数（GET 方法就是 Query 参数，POST 方法就是 Body 参数）：

{ 
      foo: 'bar'
    }

### 请求参数 ###

**Headers**

**Body**

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> mobile</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>手机号</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> code</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>验证码</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 编辑用户头像 ##

### 基本信息 ###

**Path：** /mp/v1\_0/user/photo

**Method：** PATCH

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/user/photo

### 2.  返回HTTP状态码 ###

**1. 200 OK**  
3. 401 token过期或未传  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>参数值</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Content-Type</td> 
   <td>multipart/form-data</td> 
   <td>是</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>Authorization</td> 
   <td></td> 
   <td>是</td> 
   <td>Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NDMyODQzNjYsInVzZXJfaWQiOjF9.mLYitrKsn4E4KdQd0CNPugKrH8uQmXEQTlG_JutC8jU</td> 
   <td>refresh_token</td> 
  </tr> 
 </tbody> 
</table>

**Body**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>参数类型</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>photo</td> 
   <td>file</td> 
   <td>否</td> 
   <td></td> 
   <td>头像图片</td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 编辑用户资料 ##

### 基本信息 ###

**Path：** /mp/v1\_0/user/profile

**Method：** PATCH

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/user/profile

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
3. 401 token过期或未传  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**Body**

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> name</td> 
   <td>string</td> 
   <td>非必须</td> 
   <td></td> 
   <td>用户名</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> intro</td> 
   <td>string</td> 
   <td>非必须</td> 
   <td></td> 
   <td>头条号简介</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> email</td> 
   <td>string</td> 
   <td>非必须</td> 
   <td></td> 
   <td>邮箱</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 获取人机验证码（极验 API1） ##

### 基本信息 ###

**Path：** /mp/v1\_0/captchas/:mobile

**Method：** GET

**接口描述：**

#### 1 线上接口路径 ####

http://ttapi.research.itcast.cn/mp/v1_0/captchas/:mobile

#### 2 返回HTTP状态码 ####

1.  200 OK
2.  404 手机号不正确
3.  507 服务器数据库异常

#### 3 返回值 ####

{
        "message": "OK",
        "data": {
            "success": 1,
            "gt": "f00de9ed073bd781c94509932a309159",
            "challenge": "e902f4f9b8b4e63dda3db1ae12ad018c",
            "new_captcha": true
        }
    }

### 请求参数 ###

**路径参数**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>mobile</td> 
   <td></td> 
   <td>手机号</td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 获取用户个人资料 ##

### 基本信息 ###

**Path：** /mp/v1\_0/user/profile

**Method：** GET

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/user/profile

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
3. 401 token过期或未传  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**Body**

### 返回数据 ###

## 获取短信验证码 (极验 API2） ##

### 基本信息 ###

**Path：** /mp/v1\_0/sms/codes/:mobile

**Method：** GET

**接口描述：**

#### 1 线上接口路径 ####

http://ttapi.research.itcast.cn/mp/v1_0/sms/codes/:mobile

#### 2 返回HTTP状态码 ####

1.  200 OK
2.  404 手机号不正确
3.  400 本次验证极验GeeTest 已失效
4.  403 极验验证失败
5.  507 服务器数据库异常

### 请求参数 ###

**路径参数**

**Query**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>challenge</td> 
   <td>是</td> 
   <td></td> 
   <td>GeeTest API2 参数</td> 
  </tr> 
  <tr> 
   <td>validate</td> 
   <td>是</td> 
   <td></td> 
   <td>GeeTest API2 参数</td> 
  </tr> 
  <tr> 
   <td>seccode</td> 
   <td>是</td> 
   <td></td> 
   <td>GeeTest API2 参数</td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 获取粉丝列表 ##

### 基本信息 ###

**Path：** /mp/v1\_0/followers

**Method：** GET

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/followers

### 2.  返回HTTP状态码 ###

**1. 200 OK**  
3. 401 token过期或未传  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**Query**

**Body**

### 返回数据 ###

# 新闻 #

## 收藏图片素材 ##

### 基本信息 ###

**Path：** /mp/v1\_0/user/images/:target

**Method：** PUT

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/user/images/:target

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
2. 400 请求参数错误  
3.  401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**路径参数**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>target</td> 
   <td></td> 
   <td>收藏的图片 id</td> 
  </tr> 
 </tbody> 
</table>

**Body**

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> collect</td> 
   <td>boolean</td> 
   <td>必须</td> 
   <td></td> 
   <td>是否收藏，false-取消收藏，true-添加收藏</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 上传用户图片素材 ##

### 基本信息 ###

**Path：** /mp/v1\_0/user/images

**Method：** POST

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/user/images

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
2. 400 请求参数错误  
3.  401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**Body**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>参数类型</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>image</td> 
   <td>file</td> 
   <td>是</td> 
   <td></td> 
   <td>图片</td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 修改评论置顶 ##

### 基本信息 ###

**Path：** /mp/v1\_0/comments/:target/sticky

**Method：** PUT

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/comments/:target/sticky

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
2. 400 请求参数错误  
3.  401 token过期或未传~~~~  
4. 403 没有设置这条评论的权限  
5. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**路径参数**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>target</td> 
   <td></td> 
   <td>评论或回复 id</td> 
  </tr> 
 </tbody> 
</table>

**Body**

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> sticky</td> 
   <td>boolean</td> 
   <td>必须</td> 
   <td></td> 
   <td>是否置顶</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 删除图片素材 ##

### 基本信息 ###

**Path：** /mp/v1\_0/user/images/:target

**Method：** DELETE

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/user/images/:target

### 2.  返回HTTP状态码 ###

**1. 204  删除成功，没有message消息体数据**  
2.  401 token过期或未传  
3. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**路径参数**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>target</td> 
   <td></td> 
   <td>图片 id</td> 
  </tr> 
 </tbody> 
</table>

**Body**

### 返回数据 ###

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> message</td> 
   <td>string</td> 
   <td>非必须</td> 
   <td></td> 
   <td>消息提示</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

## 删除文章 ##

### 基本信息 ###

**Path：** /mp/v1\_0/articles/:target

**Method：** DELETE

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/articles/:target

### 2.  返回HTTP状态码 ###

**1. 204  删除成功，没有message消息体数据**  
**2.** 400 指定文章有误  
3.  401 token过期或未传  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**路径参数**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>target</td> 
   <td></td> 
   <td>文章 id</td> 
  </tr> 
 </tbody> 
</table>

**Body**

### 返回数据 ###

## 删除评论或回复 ##

### 基本信息 ###

**Path：** /mp/v1\_0/comments/:target

**Method：** DELETE

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/comments/:target

### 2.  返回HTTP状态码 ###

**1. 204 OK**  
2. 403 没有删除这条评论的权限  
3.  401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**路径参数**

**Body**

### 返回数据 ###

## 发表文章（新建） ##

### 基本信息 ###

**Path：** /mp/v1\_0/articles

**Method：** POST

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/articles

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
2. 400 请求参数错误  
3.  401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**Query**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>draft</td> 
   <td>否</td> 
   <td>true 或 false</td> 
   <td>是否存为草稿（true 为草稿）</td> 
  </tr> 
 </tbody> 
</table>

**Body**

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> title</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>文章标题</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> content</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>文章内容</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> cover</td> 
   <td>object</td> 
   <td>必须</td> 
   <td></td> 
   <td>封面</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ type</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>封面类型 -1:自动，0-无图，1-1张，3-3张</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ images</td> 
   <td>string []</td> 
   <td>必须</td> 
   <td></td> 
   <td></td> 
   <td><p>item 类型: string</p></td> 
  </tr> 
  <tr> 
   <td> channel_id</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>文章所属频道id</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 取消对评论或评论回复点赞 ##

### 基本信息 ###

**Path：** /mp/v1\_0/comment/likings/:target

**Method：** DELETE

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/comment/likings/:target

### 2.  返回HTTP状态码 ###

**1. 204 OK**  
2.  401 token过期或未传~~~~  
3. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**路径参数**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>target</td> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

**Body**

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> target</td> 
   <td>string</td> 
   <td>非必须</td> 
   <td></td> 
   <td>要取消点赞的评论id或评论回复id</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 对评论或回复点赞 ##

### 基本信息 ###

**Path：** /mp/v1\_0/comment/likings

**Method：** POST

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/comment/likings

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
2. 400 请求参数错误  
3.  401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**Body**

### 返回数据 ###

## 修改文章评论状态 ##

### 基本信息 ###

**Path：** /mp/v1\_0/comments/status

**Method：** PUT

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/comments/status?article_id=xxx

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
2. 400 请求参数错误  
3.  401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**Query**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>article_id</td> 
   <td>是</td> 
   <td></td> 
   <td>文章 id</td> 
  </tr> 
 </tbody> 
</table>

**Body**

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> allow_comment</td> 
   <td>boolean</td> 
   <td>必须</td> 
   <td></td> 
   <td>是否允许评论</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 文章搜索 ##

### 基本信息 ###

**Path：** /mp/v1\_0/search

**Method：** GET

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/search

### 2.  返回HTTP状态码 ###

**1. 200 OK**  
2. 400 请求参数错误  
3. 401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 请求参数 ###

**Headers**

**Query**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>q</td> 
   <td>是</td> 
   <td></td> 
   <td>检索关键词</td> 
  </tr> 
  <tr> 
   <td>page</td> 
   <td>否</td> 
   <td></td> 
   <td>页数</td> 
  </tr> 
  <tr> 
   <td>per_page</td> 
   <td>否</td> 
   <td></td> 
   <td>每页数量</td> 
  </tr> 
 </tbody> 
</table>

**Body**

### 返回数据 ###

## 添加评论或评论回复 ##

### 基本信息 ###

**Path：** /mp/v1\_0/comments

**Method：** POST

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/comments

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
2. 400 请求参数错误  
3.  401 token过期或未传~~~~  
4. 403 文章已关闭评论  
5. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**Body**

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> target</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>评论id</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> content</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>评论回复内容</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> art_id</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>文章id</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

### 返回数据 ###

## 编辑文章（修改） ##

### 基本信息 ###

**Path：** /mp/v1\_0/articles/:target

**Method：** PUT

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/articles

### 2.  返回HTTP状态码 ###

**1. 201 OK**  
2. 400 请求参数错误  
3.  401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**路径参数**

**Query**

**Body**

### 返回数据 ###

## 获取指定文章 ##

### 基本信息 ###

**Path：** /mp/v1\_0/articles/:target

**Method：** GET

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/articles

### 2.  返回HTTP状态码 ###

**1. 200 OK**  
2. 401 token过期或未传~~~~  
3. 507 服务器数据库异常

### 请求参数 ###

**Headers**

**路径参数**

### 返回数据 ###

## 获取文章列表（适用内容管理、评论管理、图文数据） ##

### 基本信息 ###

**Path：** /mp/v1\_0/articles

**Method：** GET

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/articles

### 2.  返回HTTP状态码 ###

**1. 200 OK**  
2. 400 请求参数错误  
3. 401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 请求参数 ###

**Headers**

**Query**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>status</td> 
   <td>否</td> 
   <td></td> 
   <td>文章状态，0-草稿，1-待审核，2-审核通过，3-审核失败，4-已删除，不传为全部</td> 
  </tr> 
  <tr> 
   <td>channel_id</td> 
   <td>否</td> 
   <td></td> 
   <td>频道 id，不传为全部</td> 
  </tr> 
  <tr> 
   <td>begin_pubdate</td> 
   <td>否</td> 
   <td>2019-01-01</td> 
   <td>起始时间，不传就不限定开始时间</td> 
  </tr> 
  <tr> 
   <td>end_pubdate</td> 
   <td>否</td> 
   <td>2019-01-02</td> 
   <td>截止时间，不传就不限定结束时间</td> 
  </tr> 
  <tr> 
   <td>page</td> 
   <td>否</td> 
   <td></td> 
   <td>页数，默认是 1</td> 
  </tr> 
  <tr> 
   <td>per_page</td> 
   <td>否</td> 
   <td></td> 
   <td>每页数量，默认每页 10 条</td> 
  </tr> 
  <tr> 
   <td>response_type</td> 
   <td>否</td> 
   <td></td> 
   <td>返回数据的字段，不传返回用于内容管理的字段，传 comment 返回用于评论管理的字段，传 statistic 返回用于图文数据的字段</td> 
  </tr> 
 </tbody> 
</table>

**Body**

### 返回数据 ###

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> message</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>消息提示</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> data</td> 
   <td>object</td> 
   <td>非必须</td> 
   <td></td> 
   <td>数据</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ total_count</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>文章总数</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ page</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>当前页数</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ per_page</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>每页数量</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ results</td> 
   <td>object []</td> 
   <td>必须</td> 
   <td></td> 
   <td>文章列表</td> 
   <td><p>item 类型: object</p></td> 
  </tr> 
  <tr> 
   <td>├─ id</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>文章id</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ title</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>标题</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ status</td> 
   <td>integer</td> 
   <td>非必须</td> 
   <td></td> 
   <td>文章状态 0-草稿，1-待审核，2-审核通过，3-审核失败，4-已删除</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ pubdate</td> 
   <td>string</td> 
   <td>非必须</td> 
   <td></td> 
   <td>发布日期</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ cover</td> 
   <td>object</td> 
   <td>非必须</td> 
   <td></td> 
   <td>封面</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ type</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>封面类型</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ images</td> 
   <td>string []</td> 
   <td>必须</td> 
   <td></td> 
   <td>封面图片</td> 
   <td><p>item 类型: string</p></td> 
  </tr> 
  <tr> 
   <td>├─ comment_status</td> 
   <td>boolean</td> 
   <td>非必须</td> 
   <td></td> 
   <td>评论状态，response_type=comment时返回</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ total_comment_count</td> 
   <td>integer</td> 
   <td>非必须</td> 
   <td></td> 
   <td>总评论数，response_type=comment时返回</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ fans_comment_count</td> 
   <td>integer</td> 
   <td>非必须</td> 
   <td></td> 
   <td>粉丝评论数，response_type=comment时返回</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ comment_count</td> 
   <td>integer</td> 
   <td>非必须</td> 
   <td></td> 
   <td>评论数，response_type=statistic时返回</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ read_count</td> 
   <td>integer</td> 
   <td>非必须</td> 
   <td></td> 
   <td>阅读数，response_type=statistic时返回</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ like_count</td> 
   <td>integer</td> 
   <td>非必须</td> 
   <td></td> 
   <td>点赞数，response_type=statistic时返回</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ repost_count</td> 
   <td>integer</td> 
   <td>非必须</td> 
   <td></td> 
   <td>转发数，response_type=statistic时返回</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ collect_count</td> 
   <td>integer</td> 
   <td>非必须</td> 
   <td></td> 
   <td>收藏数，response_type=statistic时返回</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

## 获取文章频道 ##

### 基本信息 ###

**Path：** /mp/v1\_0/channels

**Method：** GET

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/channels

### 2.  返回HTTP状态码 ###

**1. 200 OK**  
2. 507 服务器数据库异常

### 请求参数 ###

**Headers**

**Body**

### 返回数据 ###

## 获取用户图片素材 ##

### 基本信息 ###

**Path：** /mp/v1\_0/user/images

**Method：** GET

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/user/images

### 2.  返回HTTP状态码 ###

**1. 200 OK**  
2. 400 请求参数错误  
3.  401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**Query**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>collect</td> 
   <td>否</td> 
   <td>true 或 false</td> 
   <td>是否是收藏的图片</td> 
  </tr> 
  <tr> 
   <td>page</td> 
   <td>否</td> 
   <td></td> 
   <td>页数</td> 
  </tr> 
  <tr> 
   <td>per_page</td> 
   <td>否</td> 
   <td></td> 
   <td>每页数量</td> 
  </tr> 
 </tbody> 
</table>

**Body**

### 返回数据 ###

## 获取评论或评论回复 ##

### 基本信息 ###

**Path：** /mp/v1\_0/comments

**Method：** GET

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/comments

### 2.  返回HTTP状态码 ###

**1. 200 OK**  
2. 400 请求参数错误  
3.  401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**Query**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>type</td> 
   <td>是</td> 
   <td>a 或 c</td> 
   <td>评论类型，a-对文章(article)的评论，c-对评论(comment)的回复</td> 
  </tr> 
  <tr> 
   <td>source</td> 
   <td>是</td> 
   <td></td> 
   <td>文章 id 或 评论 id</td> 
  </tr> 
  <tr> 
   <td>offset</td> 
   <td>否</td> 
   <td></td> 
   <td>获取评论数据的偏移量，值为评论 id，表示从此 id 的数据向后取，不传表示从第一页开始读取数据</td> 
  </tr> 
  <tr> 
   <td>limit</td> 
   <td>否</td> 
   <td></td> 
   <td>获取的评论数据个数，不传表示采用后端服务设定的默认每页数据量</td> 
  </tr> 
 </tbody> 
</table>

**Body**

### 返回数据 ###

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> message</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>消息提示</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> data</td> 
   <td>object</td> 
   <td>非必须</td> 
   <td></td> 
   <td>数据</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ total_count</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>文章的评论总数 或 评论的总回复数</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ art_id</td> 
   <td>integer</td> 
   <td>非必须</td> 
   <td></td> 
   <td>文章id，只在type=a时返回</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ art_title</td> 
   <td>string</td> 
   <td>非必须</td> 
   <td></td> 
   <td>文章标题，只在type=a时返回</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ art_pubdate</td> 
   <td>string</td> 
   <td>非必须</td> 
   <td></td> 
   <td>文章发布日期，只在type=a时返回</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ end_id</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>所有评论或回复的最后一个id（截止offset值，小于此值的offset可以不用发送请求获取评论数据，已经没有数据），若无评论或回复数据，则值为NULL</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ last_id</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>本次返回结果的最后一个评论id，作为请求下一页数据的offset参数，若本次无具体数据，则值为NULL</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ results</td> 
   <td>object []</td> 
   <td>必须</td> 
   <td></td> 
   <td>评论或回复的内容</td> 
   <td><p>item 类型: object</p></td> 
  </tr> 
  <tr> 
   <td>├─ com_id</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>评论或回复id</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ aut_id</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>评论或回复的用户id</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ aut_name</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>用户名称</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ aut_photo</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>用户头像url</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ like_count</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>点赞数量</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ reply_count</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>回复数量</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ pubdate</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>创建日期</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ content</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>评论或回复内容</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ is_top</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>是否置顶，0-不置顶，1-置顶</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ is_liking</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>是否点赞，0-未点赞，1-已点赞</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

# 统计 #

## 获取指定文章详细统计数据 ##

### 基本信息 ###

**Path：** /mp/v1\_0/statistics/articles/:article\_id

**Method：** GET

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/statistics/articles/:article_id

### 2.  返回HTTP状态码 ###

**1. 200 OK**  
2. 400 请求参数错误  
3. 401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 请求参数 ###

**Headers**

**路径参数**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>article_id</td> 
   <td></td> 
   <td>文章 id</td> 
  </tr> 
 </tbody> 
</table>

**Query**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>begin_pubdate</td> 
   <td>否</td> 
   <td>2019-01-01</td> 
   <td>起始时间</td> 
  </tr> 
  <tr> 
   <td>end_pubdate</td> 
   <td>否</td> 
   <td>2019-01-02</td> 
   <td>截止时间</td> 
  </tr> 
 </tbody> 
</table>

**Body**

### 返回数据 ###

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> message</td> 
   <td>string</td> 
   <td>必须</td> 
   <td>OK</td> 
   <td>消息提示</td> 
   <td><p>枚举: OK</p></td> 
  </tr> 
  <tr> 
   <td> data</td> 
   <td>object</td> 
   <td>必须</td> 
   <td></td> 
   <td>数据</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ avg_read_proc</td> 
   <td>number</td> 
   <td>必须</td> 
   <td></td> 
   <td>平均阅读进度</td> 
   <td><p>最大值: 1</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ bounce_rate</td> 
   <td>number</td> 
   <td>必须</td> 
   <td></td> 
   <td>跳出率</td> 
   <td><p>最大值: 1</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ time_spent</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>阅读时间，单位秒</td> 
   <td><p>最大值: 1000</p><p>最小值: 1</p></td> 
  </tr> 
  <tr> 
   <td>├─ conversion</td> 
   <td>object</td> 
   <td>必须</td> 
   <td></td> 
   <td>转化</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ reco_count</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>推荐量</td> 
   <td><p>最大值: 10000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ read_count</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>阅读量</td> 
   <td><p>最大值: 8000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ fans_read_count</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>粉丝阅读量</td> 
   <td><p>最大值: 6000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ comment_count</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>评论量</td> 
   <td><p>最大值: 7000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ origin</td> 
   <td>object</td> 
   <td>必须</td> 
   <td></td> 
   <td>来源</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ recommend</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>推荐</td> 
   <td><p>最大值: 10000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ channel</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>频道</td> 
   <td><p>最大值: 10000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ relation</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>相关</td> 
   <td><p>最大值: 10000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ outter</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>应用外</td> 
   <td><p>最大值: 10000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ other</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>其他</td> 
   <td><p>最大值: 10000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ completed</td> 
   <td>object</td> 
   <td>必须</td> 
   <td></td> 
   <td>完成度</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ gt80</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>超过80%</td> 
   <td><p>最大值: 10000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ lt80</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>低于80%</td> 
   <td><p>最大值: 10000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ lt20</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>低于20%</td> 
   <td><p>最大值: 10000</p><p>最小值: 0</p></td> 
  </tr> 
 </tbody> 
</table>

## 获取文章统计数据（总量） ##

### 基本信息 ###

**Path：** /mp/v1\_0/statistics/articles

**Method：** GET

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/statistics/articles

### 2.  返回HTTP状态码 ###

**1. 200 OK**  
2. 400 请求参数错误  
3. 401 token过期或未传~~~~  
4. 507 服务器数据库异常

### 请求参数 ###

**Headers**

**Query**

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>是否必须</th> 
   <th>示例</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>channel_id</td> 
   <td>否</td> 
   <td></td> 
   <td>频道 id，不传为全部</td> 
  </tr> 
  <tr> 
   <td>begin_pubdate</td> 
   <td>否</td> 
   <td>2019-01-01</td> 
   <td>起始时间</td> 
  </tr> 
  <tr> 
   <td>end_pubdate</td> 
   <td>否</td> 
   <td>2019-01-02</td> 
   <td>截止时间</td> 
  </tr> 
 </tbody> 
</table>

**Body**

### 返回数据 ###

## 获取粉丝统计数据 ##

### 基本信息 ###

**Path：** /mp/v1\_0/statistics/followers

**Method：** GET

**接口描述：**

#### 1. 线上地址 ####

http://ttapi.research.itcast.cn/mp/v1_0/statistics/followers

### 2.  返回HTTP状态码 ###

**1. 200 OK**  
3. 401 token过期或未传  
4. 507 服务器数据库异常

### 3. token说明 ###

**在Authorization 请求头中携带的token，格式为"Bearer "拼接上token，注意Bearer后有一个空格**

\#\#\# 请求参数 \*\*Headers\*\*

**Body**

### 返回数据 ###

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>默认值</th> 
   <th>备注</th> 
   <th>其他信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> message</td> 
   <td>string</td> 
   <td>必须</td> 
   <td></td> 
   <td>消息提示</td> 
   <td><p>枚举: OK</p></td> 
  </tr> 
  <tr> 
   <td> data</td> 
   <td>object</td> 
   <td>必须</td> 
   <td></td> 
   <td>数据</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ gender</td> 
   <td>object</td> 
   <td>必须</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ male</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>男粉丝数量</td> 
   <td><p>最大值: 1000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ female</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>女粉丝数量</td> 
   <td><p>最大值: 1000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ age</td> 
   <td>object</td> 
   <td>必须</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ le18</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>0-18</td> 
   <td><p>最大值: 300</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ le23</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>19-23</td> 
   <td><p>最大值: 300</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ le30</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>24-30</td> 
   <td><p>最大值: 300</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ le40</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>31-40</td> 
   <td><p>最大值: 300</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ le50</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>41-50</td> 
   <td><p>最大值: 300</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ gt50</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td>50+</td> 
   <td><p>最大值: 300</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ device</td> 
   <td>object</td> 
   <td>必须</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>├─ ios</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td></td> 
   <td><p>最大值: 1000</p><p>最小值: 0</p></td> 
  </tr> 
  <tr> 
   <td>├─ android</td> 
   <td>integer</td> 
   <td>必须</td> 
   <td></td> 
   <td></td> 
   <td><p>最大值: 1000</p><p>最小值: 0</p></td> 
  </tr> 
 </tbody> 
</table>

[http_ttapi.research.itcast.cn_mp]: http://ttapi.research.itcast.cn/app/