发布时间：2025-10-22 浏览：187 评论: 0 留言/反馈/举报
资源下载
文煞api接口（站群版） 简介：
一、Zblog插件：文煞api接口（站群版）免费下载
最新的Zblog插件文煞api接口（站群版）：该插件是基于Z-Blog系统开发的API接口工具，核心用于站群场景下的文章数据接口管理，支持API密钥管控、多维度文章数据调用及权限精细化控制。支持多组密钥、每组密钥可设置分类权限，如果密钥密钥某分类的权限，就算是该分类下的文章也不可调用。配合文煞CMS（api版本），可实现一个zblog程序管理内容，多个文煞CMS展示内容，实现站群功能！可到官网下载！
文煞CMS官网地址：https://www.wszzw.cn/
本插件可搭配文煞CMS（API版），建立站群系统！
二、Zblog插件：文煞api接口（站群版）核心功能介绍
1. API密钥全生命周期管理
密钥创建：支持自定义密钥名称、生成16位随机SKEY（数字+大小写字母），可选MD5/SHA1/SHA256加密方式，可指定允许访问的文章分类。
密钥编辑/删除：可修改密钥的名称、SKEY、加密方式、权限范围及启用/禁用状态，删除操作支持二次确认，防止误删。
默认配置：插件安装时自动创建“默认密钥”（MD5加密，允许所有分类），并生成存储密钥的数据库表（ wensha_api_keys ）。
2. 严格的API请求验证机制
所有API调用需通过三重验证，确保接口安全：
1. 参数校验：必传 skid （密钥自增ID）、 sign （签名）、 random （16位随机字符串），缺少则返回400错误。
2. 密钥校验：通过 skid 查询数据库，验证密钥是否存在、是否处于启用状态，不满足则返回401错误。
3. 签名校验：按规则生成签名字符串（ skid + skey + skid + random ），用指定加密方式计算签名，与传入 sign 不一致则返回401错误。
3. 多维度文章数据接口
支持8种核心数据调用动作（通过 action 参数指定），覆盖站群常见数据需求：
基础文章列表（list）：按发布时间排序，支持分页（1-100条/页）、按分类筛选。
热门文章（hot）：按阅读量排序，可指定时间范围（如近7天热门文章）。
随机文章（random）：随机返回文章，适合内容推荐场景。
单篇文章详情（post）：根据文章ID获取完整内容，调用时自动更新文章阅读量，无权限则返回403错误。
作者文章（author）：按作者ID筛选其发布的所有文章，支持分页和排序。
关键词搜索（search）：在标题/内容/摘要中搜索关键词，可结合分类筛选。
分类列表（categories）：返回所有分类信息（ID、名称、描述、文章数等），并按密钥权限过滤不可访问分类。
文章总数统计（total_posts）：统计指定分类（或全部分类）的已发布文章总数。
4. 精细化权限控制
- 分类权限隔离：每个API密钥可指定允许访问的分类（多选），未指定则允许所有分类；调用接口时自动过滤无权限的分类及对应文章。
- 数据返回控制：列表类接口支持分页参数（ page / perpage ）和排序方向（ order=asc/desc ），详情接口仅返回已发布（ log_Status=0 ）的普通文章（ log_Type=0 ）。
5. 标准化响应格式
所有接口统一返回JSON格式数据，包含状态码（200成功/400参数错误/401验证失败/403权限不足/404数据不存在）、提示信息、时间戳，列表类接口额外返回分页信息（总页数、是否有下一页）和排序信息。
三、Zblog插件：文煞API接口插件（站群版）使用文档
本文档详细说明插件的API接口调用规则、参数说明、响应格式及示例，适用于开发人员对接站群数据需求。
1. 接口基础信息
1). 通用请求信息
- 请求协议：HTTP/HTTPS（取决于Z-Blog系统部署环境）
- 请求方式：GET（所有接口均支持GET请求）
- 基础URL： {你的Z-Blog域名}/index.php?wensha_api=index（核心入口参数，不可缺少）
- 响应格式：统一JSON格式，编码为UTF-8
- 时间格式：所有时间戳均为Unix时间戳（秒级）
2). 必传公共参数
所有API调用必须携带以下3个参数，否则会返回400错误（缺少必要参数）：
| 参数名 | 类型 | 说明 | 示例 |
| skid | int | API密钥的自增ID（从插件管理页“SKID”列获取） | 1 |
| sign | string | 签名（按规则生成，确保请求合法性） | 3e25960a79dbc69b674cd4ec67a72c62 |
| random | string | 16位随机字符串（大小写字母+数字混合，每次请求建议不同） | xY3k7P9qR2sT4uF8 |
2. 签名生成规则
签名是接口安全的核心，需严格按以下步骤生成，否则会返回401错误（签名验证失败）。
1）. 生成步骤
（1）. 获取基础信息：确定当前使用的 skid 、对应密钥的 skey （从插件管理页“skey”列获取）、本次请求的 random 。
（2）. 拼接签名字符串：按固定顺序拼接 → skid + skey + skid + random
示例：skid=1，skey=Abc123Xyz789，random=xY3k7P9qR2sT4uF8 → 拼接结果为 1Abc123Xyz7891xY3k7P9qR2sT4uF8 。
（3）. 计算签名：根据密钥配置的“加密方式”（MD5/SHA1/SHA256），对拼接后的字符串进行哈希计算，结果即为 sign 。
示例：若加密方式为MD5，上述拼接字符串的MD5结果为 3e25960a79dbc69b674cd4ec67a72c62 。
2）. 签名工具推荐
- 在线工具：可使用MD5在线加密、SHA256在线计算工具快速生成。
PHP代码在线生成案例：
$skid = 1;
$skey = "Abc123Xyz789";
$random = "xY3k7P9qR2sT4uF8";
$signStr = $skid . $skey . $skid . $random;
$sign = md5($signStr); // 若为SHA256则改为hash('sha256', $signStr)
3. 核心接口详情
按 action 参数（指定接口功能）分类说明，所有接口需在基础URL后追加公共参数+接口特有参数。
1）. 文章列表接口（action=list）
功能：按发布时间排序，返回指定分类的文章列表，支持分页。
| 参数名 | 类型 | 可选/必选 | 默认值 | 说明 |
| action | string | 必选 | list | 表示使用文章列表接口 |
| page | int | 可选 | 1 | 页码最小为1 |
| perpage | int | 可选 | 10 | 每页文章数量：1-100之间（超过100自动取100） |
| cate | int | 可选 | 0 | 表示所有分类（需密钥有权限） |
| order | string | 可选 | desc | 排序方向，“desc”（降序，新文章在前）、“asc”（升序，旧文章在前） |
请求示例 ：https://www.wszzw.cn/index.php?wensha_api=index&action=list&page=1&perpage=10&cate=2&order=desc&skid=1&sign=3e25960a79dbc69b674cd4ec67a72c62&random=xY3k7P9qR2sT4uF8
成功响应示例（code=200），json数据：
{
"code": 200,
"message": "请求成功",
"data": [
{
"id": 101,
"title": "站群优化的5个核心技巧",
"content": "站群优化需注重内容差异化...", // 文章摘要
"author": "admin",
"author_id": 1,
"category": "SEO技巧",
"category_id": 2,
"tags": "站群,SEO,优化",
"views": 528,
"comments": 12,
"create_time": 1698765234,
"update_time": 1698841567,
"url": "https://yourdomain.com/post/101.html"
}
// 更多文章...
],
"pagination": {
"page": 1,
"perpage": 10,
"total": 89, // 总文章数
"total_pages": 9, // 总页数
"has_next": true, // 是否有下一页
"has_prev": false // 是否有上一页
},
"sort": {
"field": "log_PostTime",
"order": "desc"
},
"timestamp": 1699012345
}
2）. 热门文章接口（action=hot）
功能：按阅读量排序，返回指定时间范围、分类的热门文章，支持分页。
| 参数名 | 类型 | 可选/必选 | 默认值 | 说明 |
| action string 必选 - 固定值“hot” | action string 必选 - 固定值“hot” | action string 必选 - 固定值“hot” | action string 必选 - 固定值“hot” | action string 必选 - 固定值“hot” |
| page / perpage / cate / order | int/string | 可选 | 同“文章列表接口” | 仅 order 默认“desc”（阅读量从高到低） |
| days | int | 可选 | 0 | 时间范围（天），0表示所有时间，如“7”表示近7天 |
请求示例：https://www.wszzw.cn/index.php?wensha_api=index&action=hot&days=7&perpage=15&skid=1&sign=3e25960a79dbc69b674cd4ec67a72c62&random=xY3k7P9qR2sT4uF8
成功响应和'list'一样！
3）. 单篇文章详情接口（action=post）
功能：根据文章ID返回完整文章内容，调用成功后自动增加文章阅读量。
| 参数名 | 类型 | 可选/必选 | 默认值 | 说明 |
| action | string | 必选 | 固定值 | “post” |
| id | int | 必选 | - | 文章ID（不可缺少，否则返回400错误） |
请求示例：https://www.wszzw.cn/index.php?wensha_api=index&action=post&id=101&skid=1&sign=3e25960a79dbc69b674cd4ec67a72c62&random=xY3k7P9qR2sT4uF8
成功响应示例（code=200）json数据：
{
"code": 200,
"message": "请求成功",
"data": {
"id": 101,
"title": "站群优化的5个核心技巧",
"content": "<p>站群优化需注重内容差异化，避免同质化被搜索引擎惩罚...</p >", // 完整HTML内容
"author": "admin",
"author_id": 1,
"category": "SEO技巧",
"category_id": 2,
"tags": "站群,SEO,优化",
"views": 529, // 阅读量已+1
"comments": 12,
"create_time": 1698765234,
"update_time": 1698841567,
"url": "https://yourdomain.com/post/101.html",
"meta": { // 文章元信息
"keywords": "站群,SEO,优化",
"description": "站群优化需注重内容差异化..."
}
},
"timestamp": 1699012567
}4）. 其他核心接口速查表
接口功能/action值/特有参数/说明
随机文章 random page / perpage / cate 随机返回文章，无排序参数
作者文章 author author_id （必选）、 page / perpage 按作者ID筛选文章
关键词搜索 search keyword （必选）、 cate / page 搜索标题/内容/摘要中的关键词
分类列表 categories - 返回密钥有权限的所有分类信息
文章总数统计 total_posts cate （可选） 返回指定分类的已发布文章总数
4. 错误码说明
错误码 含义 常见场景
400 参数错误 缺少 id / keyword 等必选参数；参数格式错误（如 page 为负数）
401 验证失败 skid 不存在/密钥禁用；签名错误； random 不是16位字符串
403 权限不足 密钥无访问指定分类/文章的权限
404 数据不存在 文章ID不存在；搜索/筛选无结果；分类ID不存在
500 服务器异常 数据库查询错误；插件文件缺失
5. 使用注意事项
1. 密钥安全： skey 是签名核心，需妥善保管，避免泄露；建议定期更换 skey 。
2. 请求频率：避免高频次调用（如每秒超过10次），防止给Z-Blog服务器造成压力。
3. 权限控制：给不同站群节点分配不同密钥，并限制其仅访问所需分类，降低风险。
4. 数据格式：文章内容（ content ）可能包含HTML标签，对接时需根据需求处理（如过滤标签）。
网友评论