创建新文章

POST

/articles

创建一个新的文章，需要管理员权限

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json必填

示例

{
    "abbrlink": "string",
    "content_html": "string",
    "content_md": "string",
    "copyright": true,
    "copyright_author": "string",
    "copyright_author_href": "string",
    "copyright_url": "string",
    "cover_url": "string",
    "custom_published_at": "string",
    "custom_updated_at": "string",
    "enable_ai_summary": true,
    "home_sort": 0,
    "ip_location": "string",
    "is_paid": true,
    "is_premium": true,
    "is_primary_color_manual": true,
    "keywords": "string",
    "password": "string",
    "password_expiry": "string",
    "password_placeholder": "string",
    "password_tips": "string",
    "password_title": "string",
    "pin_sort": 0,
    "post_category_ids": [
        "string"
    ],
    "post_tag_ids": [
        "string"
    ],
    "premium_price": 0,
    "preview_content": "string",
    "price": 0,
    "primary_color": "string",
    "sale_price": 0,
    "show_on_home": true,
    "status": "DRAFT",
    "summaries": [
        "string"
    ],
    "title": "string",
    "top_img_url": "string",
    "visibility": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/articles' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "abbrlink": "string",
    "content_html": "string",
    "content_md": "string",
    "copyright": true,
    "copyright_author": "string",
    "copyright_author_href": "string",
    "copyright_url": "string",
    "cover_url": "string",
    "custom_published_at": "string",
    "custom_updated_at": "string",
    "enable_ai_summary": true,
    "home_sort": 0,
    "ip_location": "string",
    "is_paid": true,
    "is_premium": true,
    "is_primary_color_manual": true,
    "keywords": "string",
    "password": "string",
    "password_expiry": "string",
    "password_placeholder": "string",
    "password_tips": "string",
    "password_title": "string",
    "pin_sort": 0,
    "post_category_ids": [
        "string"
    ],
    "post_tag_ids": [
        "string"
    ],
    "premium_price": 0,
    "preview_content": "string",
    "price": 0,
    "primary_color": "string",
    "sale_price": 0,
    "show_on_home": true,
    "status": "DRAFT",
    "summaries": [
        "string"
    ],
    "title": "string",
    "top_img_url": "string",
    "visibility": "string"
}'

返回响应

🟢200

application/json

创建成功

Body

示例

{
    "code": 0,
    "data": {
        "abbrlink": "string",
        "ai_summary": "string",
        "ai_summary_generated_at": "string",
        "comment_count": 0,
        "content_html": "string",
        "content_md": "string",
        "copyright": true,
        "copyright_author": "string",
        "copyright_author_href": "string",
        "copyright_url": "string",
        "cover_url": "string",
        "created_at": "string",
        "has_access": true,
        "has_password": true,
        "home_sort": 0,
        "id": "string",
        "ip_location": "string",
        "is_paid": true,
        "is_premium": true,
        "is_primary_color_manual": true,
        "keywords": "string",
        "password_placeholder": "string",
        "password_tips": "string",
        "password_title": "string",
        "pin_sort": 0,
        "post_categories": [
            {
                "count": 0,
                "created_at": "string",
                "description": "string",
                "id": "string",
                "is_series": true,
                "name": "string",
                "updated_at": "string"
            }
        ],
        "post_tags": [
            {
                "count": 0,
                "created_at": "string",
                "id": "string",
                "name": "string",
                "updated_at": "string"
            }
        ],
        "price": 0,
        "primary_color": "string",
        "reading_time": 0,
        "sale_price": 0,
        "show_on_home": true,
        "status": "string",
        "summaries": [
            "string"
        ],
        "title": "string",
        "top_img_url": "string",
        "updated_at": "string",
        "view_count": 0,
        "visibility": "string",
        "word_count": 0
    },
    "message": "string"
}

🟠400

🟠401

🔴500

修改于 2025-12-12 13:11:01

获取文章列表

删除文章