请问，如果想用API的形式上传文章，是否有提供的API?

liuzheng2000

wan92hen

Swagger 文档：https://demo.halo.run/webjars/swagger-ui/index.html
参考插件：halo-sigs/plugin-migrate

jamine2024

你好我也在找这个方法

我参考文档目前应该是post请求
/apis/content.halo.run/v1alpha1/posts

参数不清楚是哪些确实看的人眼花缭乱必填参数是哪些啊？

curl -X 'POST' \ 'https://demo.halo.run/apis/content.halo.run/v1alpha1/posts' \ -H 'accept: */*' \ -H 'Content-Type: */*' \ -d '{ "apiVersion": "string", "kind": "string", "metadata": { "annotations": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "creationTimestamp": "2024-07-06T13:59:25.803Z", "deletionTimestamp": "2024-07-06T13:59:25.803Z", "finalizers": [ "string" ], "generateName": "string", "labels": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "name": "string", "version": 0 }, "spec": { "allowComment": true, "baseSnapshot": "string", "categories": [ "string" ], "cover": "string", "deleted": false, "excerpt": { "autoGenerate": true, "raw": "string" }, "headSnapshot": "string", "htmlMetas": [ { "additionalProp1": "string", "additionalProp2": "RTUY", "additionalProp3": "string" } ], "owner": "string", "pinned": false, "priority": 0, "publish": false, "publishTime": "2024-07-06T13:59:25.803Z", "releaseSnapshot": "string", "slug": "string", "tags": [ "string" ], "template": "string", "title": "string", "visible": "PUBLIC" }, "status": { "commentsCount": 0, "conditions": [ { "lastTransitionTime": "2024-07-06T13:59:25.803Z", "message": "string", "reason": "Y", "status": "TRUE", "type": "U" } ], "contributors": [ "string" ], "excerpt": "string", "hideFromList": true, "inProgress": true, "lastModifyTime": "2024-07-06T13:59:25.804Z", "observedVersion": 0, "permalink": "string", "phase": "string" } }'

这些都是必填参数么

Ryan Wang 👍

jamine2024 直接在后台看创建文章的请求应该更简单吧

jamine2024

Ryan Wang 👍

已经解决非常感谢！

附上代码，方便后面的小伙伴：

import requests
import uuid
import json

new_uuid = str(uuid.uuid4())
url = "http://xxx.com:8090/apis/api.console.halo.run/v1alpha1/posts"

payload = {
    "post": {
        "spec": {
            "title": "2024年7月6日",
            "slug": "2024年7月6日",
            "deleted": False,
            "publish": True,
            "pinned": False,
            "allowComment": True,
            "visible": "PUBLIC",
            "priority": 0,
            "excerpt": {
                "autoGenerate": True,
                "raw": ""
            },
            "categories": [],
            "tags": [],
            "htmlMetas": []
        },
        "apiVersion": "content.halo.run/v1alpha1",
        "kind": "Post",
        "metadata": {
            "name": new_uuid,
            "annotations": {"content.halo.run/preferred-editor": "default"}
        }
    },
    "content": {
        "raw": "<p style=\"\">我是测试</p>",
        "content": "<p style=\"\">我是测试</p>",
        "rawType": "HTML"
    }
}
headers = {
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36",
    "Content-Type": "application/json",
    "Authorization": "Bearer 你的口令令牌值"
}

response = requests.request("POST", url, json=payload, headers=headers)
# 解析JSON字符串
data = json.loads(response.text)
print(data)

Ryan Wang 👍

jamine2024 其实如果有需求用 Python 去调用 Halo 接口的话，最好是参考 Halo 的 JS Api Client 去生成 Python 的 Api Client。

参考：

Qhao6

jamine2024 试了一下，发现不能上传，返回为空，后台也没有什么报错，要在headers里加上Cookie参数才行

jamine2024

Ryan Wang 👍 好的非常那个感谢

Qhao6

Qhao6 2.19版本