API 接口

XPCMS 提供的对外开放接口，统一返回 JSON 格式，所有请求需携带 X-CSRF-Token 头。

响应规范

{
    "code": 0,           // 0=成功，其他=失败
    "message": "success",
    "data": { ... }
}

会员登录

POST /member/login
Content-Type: application/json

{
    "username": "penghao",
    "password": "******",
    "remember": true
}

文章列表

GET /article?page=1&page_size=10&category_id=2

Response:
{
    "code": 0,
    "data": {
        "list": [...],
        "total": 128,
        "page": 1,
        "page_size": 10
    }
}

留言提交

POST /contact
X-CSRF-Token: {token}
Content-Type: application/json

{
    "name": "张三",
    "contact": "13800138000",
    "content": "您好，咨询一下产品价格"
}

错误码

• 0 成功
• 1001 参数错误
• 1002 未登录
• 1003 权限不足
• 1004 资源不存在
• 2001 CSRF 校验失败
• 3001 限流拦截