接口概述

本接口用于获取信息业务宝典站点的文章列表数据。

一、Token 生成接口

1. 接口信息

• 请求 URL：https://dyh.591220.com/wp-json/custom-jwt/v1/token
• 请求方法：POST
• Content-Type：application/json

2. 请求参数（JSON 格式）

表格

参数名	类型	必填	说明	示例值
username	string	是	用户名	dyh-soft-development
password	string	是	密码	Aa.dsd123

3. 请求示例

bash

运行

curl -X POST https://dyh.591220.com/wp-json/custom-jwt/v1/token \
  -H "Content-Type: application/json" \
  -d '{
    "username": "dyh-soft-development",
    "password": "Aa.dsd123"
  }'

4. 响应示例（成功）

json

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2R5aC41OTEyMjAuY29tIiwiaWF0IjoxNzE0MzEzMDAwLCJleHAiOjE3MTQ0MDMwMDAsImRhdGEiOnsidXNlciI6eyJpZCI6MSwidXNlcm5hbWUiOiJkeWgtc29mdC1kZXZlbG9wbWVudCIsInJvbGUiOiJhZG1pbmlzdHJhdG9yIn19fQ.xxxxxx",
  "expires_in": 86400,
  "user": {
    "id": 1,
    "username": "dyh-soft-development"
  }
}

5. 响应参数说明

表格

参数名	类型	说明
token	string	JWT 授权 Token（有效期 24 小时）
expires_in	int	Token 有效期（秒），固定 86400
user	object	授权用户基础信息

6. 错误响应示例

json

{
  "code": "invalid_credentials",
  "message": "用户名或密码错误",
  "data": {
    "status": 401
  }
}

二、文章列表查询接口

1. 接口信息

• 请求 URL：https://dyh.591220.com/wp-json/wp/v2/posts
• 请求方法：GET
• 授权方式：Bearer Token（放在请求头）

2. 请求头参数

表格

参数名	类型	必填	说明	示例值
Authorization	string	是	Bearer + 空格 + 生成的 Token 值	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…

3. URL 查询参数

表格

参数名	类型	必填	说明	示例值	默认值
per_page	int	否	每页显示文章数量	10	10
page	int	否	页码（从 1 开始）	2	1
order	string	否	排序方式（asc/desc）	desc	desc
orderby	string	否	排序字段（date/id 等）	date	date

4. 请求示例（带分页 + Token）

bash

运行

curl -X GET "https://dyh.591220.com/wp-json/wp/v2/posts?per_page=10&page=2" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2R5aC41OTEyMjAuY29tIiwiaWF0IjoxNzE0MzEzMDAwLCJleHAiOjE3MTQ0MDMwMDAsImRhdGEiOnsidXNlciI6eyJpZCI6MSwidXNlcm5hbWUiOiJkeWgtc29mdC1kZXZlbG9wbWVudCIsInJvbGUiOiJhZG1pbmlzdHJhdG9yIn19fQ.xxxxxx"

5. 响应示例（成功）

json

[
  {
    "id": 11,
    "date": "2026-03-19T10:00:00",
    "date_gmt": "2026-03-19T02:00:00",
    "guid": {
      "rendered": "https://dyh.591220.com/?p=11"
    },
    "modified": "2026-03-19T10:00:00",
    "modified_gmt": "2026-03-19T02:00:00",
    "slug": "sample-post-11",
    "status": "publish",
    "type": "post",
    "link": "https://dyh.591220.com/2026/03/19/sample-post-11/",
    "title": {
      "rendered": "示例文章标题11"
    },
    "content": {
      "rendered": "<p>文章内容...</p>\n",
      "protected": false
    },
    "excerpt": {
      "rendered": "<p>文章摘要...</p>\n",
      "protected": false
    },
    "author": 1,
    "featured_media": 0,
    "comment_status": "open",
    "ping_status": "open",
    "sticky": false,
    "template": "",
    "format": "standard",
    "meta": [],
    "categories": [1],
    "tags": [],
    "_links": {
      "self": [{"href": "https://dyh.591220.com/wp-json/wp/v2/posts/11"}],
      "collection": [{"href": "https://dyh.591220.com/wp-json/wp/v2/posts"}]
    }
  },
  // 更多文章...
]

6. 错误响应示例

6.1 未携带 Token

json

{
  "code": "jwt_no_token",
  "message": "必须提供有效的 JWT Token",
  "data": {
    "status": 401
  }
}

6.2 Token 无效 / 过期

json

{
  "code": "jwt_expired",
  "message": "Token 已过期",
  "data": {
    "status": 401
  }
}

6.3 Token 签名验证失败

json

{
  "code": "jwt_invalid_signature",
  "message": "Token 签名验证失败",
  "data": {
    "status": 401
  }
}

三、使用注意事项

1. Token 有效期：生成的 Token 有效期为 24 小时（86400 秒），过期后需重新调用 Token 接口生成；
2. 权限说明：当前账号（dyh-soft-development）可访问所有公开文章；
3. 分页限制：per_page 参数最大支持 100 条 / 页，超出将自动按 100 条处理；
4. 请求频率：建议合理控制请求频率，避免高频请求导致服务器限制；
5. HTTPS 要求：所有请求必须使用 HTTPS 协议，HTTP 请求将被重定向至 HTTPS；
6. 参数编码：URL 查询参数需做 URL 编码，避免特殊字符导致请求失败。

四、常见问题排查

1. Token 生成失败：检查用户名 / 密码是否正确，确保账号为有效用户；
2. Token 验证失败：确认 Token 未被篡改、未过期，且请求头格式为 Bearer + 空格 + Token；
3. 文章列表为空：检查 page 参数是否超出总页数，或站点暂无文章数据；
4. 403 错误：确认已按文档要求配置 Token，且账号有访问文章的权限。

总结

1. 调用文章列表接口前，需先通过 /custom-jwt/v1/token 生成有效 JWT Token，核心账号信息为用户名 dyh-soft-development、密码 Aa.dsd123；
2. 文章列表接口支持分页（per_page/page）等查询参数，请求时需在 Header 中携带 Authorization: Bearer {Token}；
3. 常见错误包括 Token 缺失、过期、签名错误，需根据响应提示排查并重新生成 Token。