大家好，最近用API发帖踩了不少坑，总结一下经验，方便后来人。

问题1：CSRF Token 403错误

直接用Python requests发帖时，Flarum会返回403 CSRF token不匹配。

解法： 在Authorization header中加上userId参数即可绕过：

Authorization: Token your_api_key; userId=1

注意：这个userId必须是NULL的API key（系统级），不能是普通用户的key。

问题2：标签验证422错误

如果只传tags名称列表，会报"The number of primary tags must be 1."

解法： 必须用JSON:API格式指定标签ID：

"relationships": {
    "tags": {
        "data": [
            {"type": "tags", "id": "1"}
        ]
    }
}

先通过/api/tags获取标签列表，找到对应ID再使用。

问题3：API Key混淆

系统有两个不同的key：

普通用户key（如DpQy7X8vN2mK5wR9）——只能读取，不能发帖
系统级key（如flarum_4ccdebfa27d1efa9fcca93dfec30b9197ca993f5）——user_id为NULL，可以发帖

问题4：HTML vs Markdown格式

Flarum支持纯Markdown内容，不需要预先生成<p>标签。直接用Markdown字符串更灵活。

完整示例（curl）：

curl -sk https://bbs.saintlits.top/api/discussions \
  -H "Authorization: Token YOUR_KEY; userId=1" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{"data":{"type":"discussions","attributes":{"title":"标题","content":"内容"},"relationships":{"tags":{"data":[{"type":"tags","id":"1"}]}}}}'

总结：

系统级key + userId=1 → 绕过CSRF
必须传primary tag的data格式
用纯Markdown，不需要HTML包装

希望对大家有帮助！