获取指定文档的下一个文档信息,通常用于文档详情页的上下篇导航功能。如果指定文档是最后一个文档,则返回空结果。
注意事项
- 接口按照文档 ID 顺序查找下一个文档
- 当指定文档为最后一个文档时,返回的 data 为 null
- 仅返回文档的基本信息,不包含文档内容详情
- 接口会返回同分类下的下一个文档
请求地址
{域名地址}/api/archive/next
说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/archive/next
请求语法
GET {域名地址}/api/archive/next?{参数}
请求头
此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。
请求参数
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 是 | 文档 ID |
响应头
此接口仅涉及公共相应头。更多信息,请参见公共请求头(Common Request Headers)。
返回参数
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 错误码 |
| msg | string | 错误原因说明 |
| data | object | 结果内容 |
data 参数
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | int | 文档 ID |
| title | string | 文档标题 |
| seo_title | string | 文档 SEO 标题 |
| url_token | string | 文档 URL 别名 |
| keywords | string | 文档关键词 |
| description | string | 文档简介 |
| module_id | int | 文档模型 ID |
| category_id | int | 文档分类 ID |
| views | int | 文档浏览量 |
| comment_count | int | 文档评论量 |
| images | string[] | 文档组图 |
| logo | string | 文档 Logo |
| thumb | string | 文档缩略图 |
| flag | string | 文档推荐属性,头条[h]推荐[c]幻灯[f]特荐[a]滚动[s]加粗[h]图片[p]跳转[j] |
| canonical_url | string | canonical url |
| fixed_link | string | 文档固定链接 |
| created_time | int | 文档发布时间戳 |
| updated_time | int | 文档更新时间戳 |
| status | int | 文档显示状态 |
| user_id | int | 用户 ID |
| price | int | 价格,单位分 |
| stock | int | 库存量 |
| user_id | int | 用户 ID |
使用示例
请求示例
GET /api/archive/next?id=3 HTTP/1.1
Host: your-domain.com
Content-Type: application/json
响应示例
{
"code": 0,
"data": {
"id": 3,
"created_time": 1607308858,
"updated_time": 1611373923,
"title": "AnqiCMS使用帮助",
"seo_title": "",
"url_token": "help",
"keywords": "",
"description": "AnqiCMS使用帮助",
"module_id": 1,
"category_id": 1,
"views": 1256,
"comment_count": 0,
"images": null,
"template": "",
"status": 1,
"canonical_url": "",
"fixed_link": "",
"flag": "",
"user_id": 0,
"price": 0,
"stock": 9999999,
"logo": "https://www.anqicms.com/uploads/20225/27/5cd9e65be13cbe6b.webp",
"thumb": "https://www.anqicms.com/uploads/20225/27/5cd9e65be13cbe6b.webp",
"link": "https://www.anqicms.com/help"
},
"msg": ""
}
当前文档为最后一个文档时:
{
"code": 0,
"data": null,
"msg": ""
}
错误代码
| 错误码 | 说明 |
|---|---|
| 0 | OK |
| -1 | 错误,错误原因在 msg 中指出 |
| 1001 | 未登录 |
| 1002 | 未授权 |
| 200 | API 请求 OK |