Z-Blog Wiki Z-Blog Wiki

Z-Blog官方文库

用户工具

站点工具


zblogphp:development:api:mods:tag

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

zblogphp:development:api:mods:tag [2020/09/13 11:12] (当前版本)
心扬 创建
行 1: 行 1:
 +====== 标签模块 ======
  
 +
 +===== 新增/​修改标签:post =====
 +
 +==== 请求 ====
 +
 +POST ''​https://​example.com/​api.php?​mod=tag&​act=post''​
 +
 +  * Headers
 +
 +见通用请求头
 +
 +  * Cookies
 +
 +
 +
 +  * Body
 +
 +请求数据请参考后台标签编辑页面的表单。
 +
 +
 +==== 响应 ====
 +
 +  * Headers
 +
 +见通用响应头
 +
 +  * Cookies
 +
 +
 +
 +  * Body
 +
 +见通用响应体
 +
 +===== 获取标签信息:get =====
 +
 +==== 请求 ====
 +
 +POST ''​https://​example.com/​api.php?​mod=tag&​act=get''​
 +
 +GET  ''​https://​example.com/​api.php?​mod=tag&​act=get&​id=1''​
 +
 +  * Headers
 +
 +见通用请求头
 +
 +  * Cookies
 +
 +见通用请求Cookies
 +
 +  * Body
 +
 +若为 POST 请求:
 +
 +^ 属性 ^ 类型 ^ 示例值 ^ 说明 ​  ^
 +| id   | int  | 1      | 标签id |
 +
 +==== 响应 ====
 +
 +  * Headers
 +
 +见通用响应头
 +
 +  * Cookies
 +
 +
 +
 +  *Body
 +
 +<​code>​
 +{
 +    "​code":​ 200,
 +    "​message":​ "​OK",​
 +    "​data":​ {
 +      "​id":​ 1,
 +        "​name":​ "​未命名",​
 +        "​alias":​ "​unnamed",​
 +        "​intro":​ "​摘要",​
 +        ...
 +    }
 +}
 +</​code>​
 +
 +data 内容:
 +^ 属性 ​      ^ 类型 ​   ^ 示例值 ​ ^ 说明 ​              ^
 +| id         | int     | 2       | 标签id ​            |
 +| name       | string ​ | 未命名 ​ | 名称 ​              |
 +| alias      | string ​ | unnamed | 别名 ​              |
 +| intro      | string ​ | 摘要 ​   | 摘要 ​              |
 +| template ​  | string ​ | index   | 模板 ​              |
 +| add_navbar | boolean | false   | 是否加入导航栏菜单 |
 +
 +===== 删除标签:delete =====
 +
 +==== 请求 ====
 +
 +POST ''​https://​example.com/​api.php?​mod=tag&​act=delete''​
 +
 +
 +  * Headers
 +
 +见通用请求头
 +
 +  * Cookies
 +
 +见通用请求Cookies
 +
 +  * Body
 +
 +^ 属性 ^ 类型 ^ 示例值 ^ 说明 ​  ^
 +| id   | int  | 1      | 待删除的标签id |
 +
 +
 +
 +<​code>​
 +{
 +    "​id":​ 1
 +}
 +</​code>​
 +
 +
 +==== 响应 ====
 +
 +  * Headers
 +
 +见通用响应头
 +
 +  * Cookies
 +
 +
 +
 +  *Body
 +见通用响应体
 +
 +
 +===== 获取标签列表:get_list =====
 +
 +==== 请求 ====
 +
 +GET/POST ''​https://​example.com/​api.php?​mod=tag&​act=list''​
 +
 +
 +  * Headers
 +
 +见通用请求头
 +
 +  * Cookies
 +
 +见通用请求Cookies
 +
 +  * Body
 +
 +
 +
 +
 +==== 响应 ====
 +
 +  * Headers
 +
 +见通用响应头
 +
 +  * Cookies
 +
 +
 +
 +  *Body
 +<​code>​
 +{
 +    "​code":​ 200,
 +    "​message":​ "​OK",​
 +    "​data":​ [{
 +        "​id":​ 1,
 +        "​name":​ "​未命名",​
 +        "​alias":​ "​unnamed",​
 +        "​intro":​ "​摘要",​
 +        ...
 +    }]
 +}
 +</​code>​
 +data 为数组,数组元素内容参见获取标签信息接口。
zblogphp/development/api/mods/tag.txt · 最后更改: 2020/09/13 11:12 由 心扬