添加文章接口

接口说明

创建新的文章。支持设置文章的分类、标题、内容、发布日期等信息，可以创建私密或加密文章。

  • 接口URL: /api/articles/add
  • 请求方法: POST
  • 权限要求: 必须登录后使用，需要有效的JWT令牌

请求参数

参数名 类型 必填 说明 示例值
article_classify_id number 是 文章分类ID 1
article_title string 是 文章标题 "示例文章"
article_title_image string 否 文章标题图片URL "https://example.com/image.jpg"
article_text string 是 文章内容 "这是文章的内容..."
article_date string 是 文章发布日期 "2024-01-01"
article_copyright string 否 文章版权信息 "版权所有©2024"
article_keywords string 否 文章关键词 "技术,博客"
article_private number 否 是否私密文章(0:否, 1:是) 0
article_password string 否 文章访问密码 "123456"

响应结构

typescript 复制代码 
interface Response {
  code: number;      // 状态码
  message: string;   // 响应消息
  data: null;        // 无返回数据
}

响应示例

json 复制代码 
{
  "code": 0,
  "message": "文章添加成功",
  "data": null
}

特殊说明

权限验证

  • 必须携带有效的JWT令牌才能调用此接口
  • 未登录或令牌失效将返回401错误

文章属性

  • 私密文章(article_private=1)：仅登录用户可见
  • 加密文章：设置article_password后，需要密码才能访问
  • 普通文章：默认所有用户可见

错误码说明

错误码 说明 处理建议
0 成功 -
401 未登录或登录失效 请先登录或更新令牌
500 服务器错误 请联系管理员

调用示例

创建普通文章

typescript 复制代码 
const response = await fetch('/api/articles/add', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your-jwt-token'
  },
  body: JSON.stringify({
    article_classify_id: 1,
    article_title: "示例文章",
    article_text: "这是文章内容...",
    article_date: "2024-01-01"
  })
});

创建加密文章

typescript 复制代码 
const response = await fetch('/api/articles/add', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your-jwt-token'
  },
  body: JSON.stringify({
    article_classify_id: 1,
    article_title: "加密文章",
    article_text: "这是加密文章内容...",
    article_date: "2024-01-01",
    article_password: "123456"
  })
});