Z-Blog Wiki

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。
====== 标签模块 ======


===== 新增/修改标签：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 为数组，数组元素内容参见获取标签信息接口。
Z-Blog Wiki

用户工具

站点工具

页面工具
