tzxblog博客系统-接口文档

喜欢ヅ旅行 2023-07-03 04:55 47阅读 0赞

# V1.0 #

# 接口安全说明 #

所有接口需要实现签名，前台向后台发起请求前需要在header中添加签名参数和签名，以减少后台服务器的被攻击可能性。  
签名参数至少包含url、时间戳，有token的接口也需要对token签名，以参数名首字母排序后使用&符号拼接后，进行rsa256算法签名。

--------------------

# 环境说明 #

<table> 
 <thead> 
  <tr> 
   <th align="left">环境名称</th> 
   <th align="left">协议</th> 
   <th align="left">IP/域名</th> 
   <th align="left">端口</th> 
   <th align="left">私钥</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">开发环境</td> 
   <td align="left">HTTP</td> 
   <td align="left">127.0.0.1</td> 
   <td align="left">8080</td> 
   <td align="left">-</td> 
  </tr> 
  <tr> 
   <td align="left">测试环境</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
  </tr> 
  <tr> 
   <td align="left">联调环境</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
  </tr> 
  <tr> 
   <td align="left">预生产环境</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
  </tr> 
  <tr> 
   <td align="left">生产环境</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
   <td align="left">-</td> 
  </tr> 
 </tbody> 
</table>

# 统一响应对象 #

<table> 
 <thead> 
  <tr> 
   <th align="left">参数名称</th> 
   <th align="left">数据类型</th> 
   <th align="left">是否必须</th> 
   <th align="left">参数描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">code</td> 
   <td align="left">String</td> 
   <td align="left">Y</td> 
   <td align="left">响应码</td> 
  </tr> 
  <tr> 
   <td align="left">msg</td> 
   <td align="left">String</td> 
   <td align="left">Y</td> 
   <td align="left">响应描述</td> 
  </tr> 
  <tr> 
   <td align="left">requestId</td> 
   <td align="left">String</td> 
   <td align="left">Y</td> 
   <td align="left">请求id</td> 
  </tr> 
  <tr> 
   <td align="left">data</td> 
   <td align="left">Object</td> 
   <td align="left">N</td> 
   <td align="left">响应结果</td> 
  </tr> 
 </tbody> 
</table>

# 接口定义 #

## 文章分类或归档列表查询 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>文章分类或归档列表查询</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/blog/category-list</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>GET</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td>URL参数</td> 
   <td>queryType</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>index:首页； user:用户； recom:推荐；hot:热门； file:归档</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>userId</td> 
   <td>String</td> 
   <td>N</td> 
   <td>用户id</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>List</td> 
   <td>N</td> 
   <td>分类对象列表，参见附录CategoryInfo</td> 
  </tr> 
 </tbody> 
</table>

## 文章列表分页查询 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>文章列表分页查询</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/blog/blog-list</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>GET</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td>URL参数</td> 
   <td>queryType</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>index:首页；user:用户；recom:推荐；hot:热门；file:归档</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>pageIndex</td> 
   <td>Long</td> 
   <td>N</td> 
   <td>页码，默认1</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>pagSize</td> 
   <td>Long</td> 
   <td>N</td> 
   <td>页数，默认10</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>userId</td> 
   <td>String</td> 
   <td>N</td> 
   <td>用户id</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>PageInfo</td> 
   <td>N</td> 
   <td>分页博客对象，参见附录PageInfo</td> 
  </tr> 
 </tbody> 
</table>

## 文章详情查询 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>文章详情查询</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/blog/bloginfo</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>GET</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td>URL参数</td> 
   <td>blogId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客id</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>BlogInfo</td> 
   <td>N</td> 
   <td>博客对象</td> 
  </tr> 
 </tbody> 
</table>

## 文章发布 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>文章发布</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/blog/add-blog</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>POST</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>Content-Type</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>application/json</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>token</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>token</td> 
  </tr> 
  <tr> 
   <td>Body参数</td> 
   <td>blogTitle</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客标题</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>blogContent</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客内容</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>blogCategroy</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>网站博客分类</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>blogUserCategroy</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>个人分类</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>blogType</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客类型： original：原创；reprint：转载；translate：翻译；</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>blogPower</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客权限：private:私密；public：公开</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>String</td> 
   <td>N</td> 
   <td>博客id</td> 
  </tr> 
 </tbody> 
</table>

## 文章删除 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>文章删除</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/blog/remove-blog</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>DELETE</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>token</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>token</td> 
  </tr> 
  <tr> 
   <td>URL参数</td> 
   <td>blogId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客id</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>String</td> 
   <td>N</td> 
   <td>博客id</td> 
  </tr> 
 </tbody> 
</table>

## 文章修改 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>文章修改</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/blog/update-blog</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>POST</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>Content-Type</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>application/json</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>token</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>token</td> 
  </tr> 
  <tr> 
   <td>Body参数</td> 
   <td>blogTitle</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客标题</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>blogContent</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客内容</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>blogCategroy</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>网站博客分类</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>blogUserCategroy</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>个人分类</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>blogType</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客类型：original：原创； reprint：转载；translate：翻译；</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>blogPower</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客权限： private:私密；public：公开</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>String</td> 
   <td>N</td> 
   <td>博客id</td> 
  </tr> 
 </tbody> 
</table>

## 评论列表分页查询 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>评论列表分页查询</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/comment/comment-list</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>GET</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td>URL参数</td> 
   <td>pageIndex</td> 
   <td>Long</td> 
   <td>N</td> 
   <td>页码，默认1</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>pagSize</td> 
   <td>Long</td> 
   <td>N</td> 
   <td>页数，默认10</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>userId</td> 
   <td>String</td> 
   <td>N</td> 
   <td>用户id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>blogId</td> 
   <td>String</td> 
   <td>N</td> 
   <td>博客id</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>PageInfo</td> 
   <td>N</td> 
   <td>评论分页对象，参见附录PageInfo</td> 
  </tr> 
 </tbody> 
</table>

## 文章评论 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>文章评论</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/comment/add-comment</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>POST</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>Content-Type</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>application/json</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>token</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>token</td> 
  </tr> 
  <tr> 
   <td>Body参数</td> 
   <td>blogId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>commentContent</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>评论内容</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>String</td> 
   <td>N</td> 
   <td>博客id</td> 
  </tr> 
 </tbody> 
</table>

## 文件列表分页查询 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>文件列表分页查询</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/file/file-list</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>GET</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td>URL参数</td> 
   <td>pageIndex</td> 
   <td>Long</td> 
   <td>N</td> 
   <td>页码，默认1</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>pagSize</td> 
   <td>Long</td> 
   <td>N</td> 
   <td>页数，默认10</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>PageInfo&lt;FileInfo</td> 
   <td>N</td> 
   <td>评论分页对象，参见附录PageInfo&lt;FileInfo</td> 
  </tr> 
 </tbody> 
</table>

## 文件上传 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>文件上传</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/file/upload-file</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>POST</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>Content-Type</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>multipart/form-data</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>token</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>token</td> 
  </tr> 
  <tr> 
   <td>Form参数</td> 
   <td>fileName</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>文件名称</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>file</td> 
   <td>MultipartFile</td> 
   <td>Y</td> 
   <td>文件</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>String</td> 
   <td>N</td> 
   <td>文件id</td> 
  </tr> 
 </tbody> 
</table>

## 文件下载 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>文件下载</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/file/download-file</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>POST</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>Content-Type</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>multipart/form-data</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>token</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>token</td> 
  </tr> 
  <tr> 
   <td>URL参数</td> 
   <td>fileId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>文件id</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>-</td> 
   <td>-</td> 
   <td>-</td> 
   <td>-</td> 
   <td>-</td> 
  </tr> 
 </tbody> 
</table>

## 用户基本信息查询 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>用户基本信息查询</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/user/userinfo</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>GET</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td>URL参数</td> 
   <td>userId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>用户id</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>UserInfo</td> 
   <td>N</td> 
   <td>用户信息</td> 
  </tr> 
 </tbody> 
</table>

## 用户注册 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>用户注册</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/user/register</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>POST</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>Content-Type</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>application/json</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td>Body参数</td> 
   <td>userAccount</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>账号</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>password</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>密码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>rePassword</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>密码确认</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>userPhone</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>手机号</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>userEmail</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>邮箱</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>userName</td> 
   <td>String</td> 
   <td>N</td> 
   <td>姓名</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>userNick</td> 
   <td>String</td> 
   <td>N</td> 
   <td>昵称</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>userAge</td> 
   <td>Integer</td> 
   <td>N</td> 
   <td>年龄</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>userDesc</td> 
   <td>String</td> 
   <td>N</td> 
   <td>简介</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>userAddr</td> 
   <td>String</td> 
   <td>N</td> 
   <td>地址</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>String</td> 
   <td>N</td> 
   <td>用户id</td> 
  </tr> 
 </tbody> 
</table>

## 用户登录 ##

--------------------

<table> 
 <thead> 
  <tr> 
   <th>接口名称</th> 
   <th>用户登录</th> 
   <th></th> 
   <th></th> 
   <th></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>URL</td> 
   <td>tzxblog/user/login</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>协议</td> 
   <td>HTTP</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求类型</td> 
   <td>POST</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>请求参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td>Header参数</td> 
   <td>Content-Type</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>application/json</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>timestamp</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>时间戳</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>sign</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>签名</td> 
  </tr> 
  <tr> 
   <td>Body参数</td> 
   <td>userAccount</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>账号</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>password</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>密码</td> 
  </tr> 
  <tr> 
   <td>响应参数</td> 
   <td>参数名称</td> 
   <td>数据类型</td> 
   <td>是否必须</td> 
   <td>参数描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>code</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应码</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>msg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>响应描述</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>requestId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>请求id</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>data</td> 
   <td>LoginInfo</td> 
   <td>N</td> 
   <td>登录信息</td> 
  </tr> 
 </tbody> 
</table>

--------------------

# 附录 #

## 附录一 ##

### CategoryInfo ###

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>数据类型</th> 
   <th>是否必须</th> 
   <th>属性描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>id</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>分类id</td> 
  </tr> 
  <tr> 
   <td>name</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>分类名称</td> 
  </tr> 
 </tbody> 
</table>

### PageInfo ###

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>数据类型</th> 
   <th>是否必须</th> 
   <th>属性描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>pageIndex</td> 
   <td>Long</td> 
   <td>Y</td> 
   <td>页码</td> 
  </tr> 
  <tr> 
   <td>pageSize</td> 
   <td>Long</td> 
   <td>Y</td> 
   <td>每页数量</td> 
  </tr> 
  <tr> 
   <td>totalCount</td> 
   <td>Long</td> 
   <td>Y</td> 
   <td>总数</td> 
  </tr> 
  <tr> 
   <td>pageCount</td> 
   <td>Long</td> 
   <td>Y</td> 
   <td>页数</td> 
  </tr> 
  <tr> 
   <td>pageContent</td> 
   <td>Object</td> 
   <td>N</td> 
   <td>分页内容</td> 
  </tr> 
 </tbody> 
</table>

### BlogInfo ###

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>数据类型</th> 
   <th>是否必须</th> 
   <th>属性描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>id</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客id</td> 
  </tr> 
  <tr> 
   <td>blogTitle</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客标题</td> 
  </tr> 
  <tr> 
   <td>blogAbstract</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客摘要</td> 
  </tr> 
  <tr> 
   <td>readCount</td> 
   <td>Long</td> 
   <td>Y</td> 
   <td>阅读数</td> 
  </tr> 
  <tr> 
   <td>commentCount</td> 
   <td>Long</td> 
   <td>Y</td> 
   <td>评论数</td> 
  </tr> 
  <tr> 
   <td>updateTime</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>更新时间</td> 
  </tr> 
  <tr> 
   <td>createTime</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>创建时间</td> 
  </tr> 
  <tr> 
   <td>blogContent</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客内容</td> 
  </tr> 
  <tr> 
   <td>blogCategroy</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>网站博客分类</td> 
  </tr> 
  <tr> 
   <td>blogUserCategroy</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>个人分类</td> 
  </tr> 
  <tr> 
   <td>blogType</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客类型： original：原创；reprint：转载；translate：翻译；</td> 
  </tr> 
  <tr> 
   <td>blogPower</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>博客权限：private:私密； public：公开</td> 
  </tr> 
  <tr> 
   <td>userId</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>用户id</td> 
  </tr> 
  <tr> 
   <td>userNick</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>用户昵称</td> 
  </tr> 
 </tbody> 
</table>

### CommentInfo ###

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>数据类型</th> 
   <th>是否必须</th> 
   <th>属性描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>id</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>评论id</td> 
  </tr> 
  <tr> 
   <td>updateTime</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>更新时间</td> 
  </tr> 
  <tr> 
   <td>createTime</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>创建时间</td> 
  </tr> 
  <tr> 
   <td>commentContent</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>评论内容</td> 
  </tr> 
 </tbody> 
</table>

### FileInfo ###

### UserInfo ###

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>数据类型</th> 
   <th>是否必须</th> 
   <th>属性描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>id</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>文件id</td> 
  </tr> 
  <tr> 
   <td>updateTime</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>更新时间</td> 
  </tr> 
  <tr> 
   <td>createTime</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>创建时间</td> 
  </tr> 
  <tr> 
   <td>userAccount</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>账号</td> 
  </tr> 
  <tr> 
   <td>userName</td> 
   <td>String</td> 
   <td>N</td> 
   <td>姓名</td> 
  </tr> 
  <tr> 
   <td>userNick</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>昵称</td> 
  </tr> 
  <tr> 
   <td>userAge</td> 
   <td>Integer</td> 
   <td>N</td> 
   <td>年龄</td> 
  </tr> 
  <tr> 
   <td>userDesc</td> 
   <td>String</td> 
   <td>N</td> 
   <td>简介</td> 
  </tr> 
  <tr> 
   <td>userAddr</td> 
   <td>String</td> 
   <td>N</td> 
   <td>地址</td> 
  </tr> 
  <tr> 
   <td>userPhone</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>手机号</td> 
  </tr> 
  <tr> 
   <td>userEmail</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>邮箱</td> 
  </tr> 
  <tr> 
   <td>userImg</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>头像url</td> 
  </tr> 
 </tbody> 
</table>

### LoginInfo ###

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>数据类型</th> 
   <th>是否必须</th> 
   <th>属性描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>user</td> 
   <td>UserInfo</td> 
   <td>Y</td> 
   <td>用户对象</td> 
  </tr> 
  <tr> 
   <td>token</td> 
   <td>UserToken</td> 
   <td>Y</td> 
   <td>用户token对象</td> 
  </tr> 
 </tbody> 
</table>

### UserToken ###

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>数据类型</th> 
   <th>是否必须</th> 
   <th>属性描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>access_token</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>AT</td> 
  </tr> 
  <tr> 
   <td>expires_in</td> 
   <td>Long</td> 
   <td>Y</td> 
   <td>AT有效期</td> 
  </tr> 
  <tr> 
   <td>refresh_token</td> 
   <td>String</td> 
   <td>Y</td> 
   <td>RT</td> 
  </tr> 
  <tr> 
   <td>refresh_expires_in</td> 
   <td>Long</td> 
   <td>Y</td> 
   <td>RT有效期</td> 
  </tr> 
  <tr> 
   <td>scope</td> 
   <td>String</td> 
   <td>N</td> 
   <td>用户权限，备用</td> 
  </tr> 
 </tbody> 
</table>

# 项目地址 #

项目代码和文档均以github托管，地址如下：  
[https://github.com/tuzongxun/tzxblog][https_github.com_tuzongxun_tzxblog]

[https_github.com_tuzongxun_tzxblog]: https://github.com/tuzongxun/tzxblog