> 此文档仍在更新中... # 基础地址 `https://forum.hamcq.cn` # 身份认证 API 使用基于令牌的身份验证机制。 ### 获取 Token `POST /api/token` ```json { "identification": "Toby", "password": "pass7word" } ``` `HTTP/1.1 200 OK` ```json { "token": "YACub2KLfe8mfmHPcUKtt6t2SMJOGPXnZbqhc3nX", "userId": "1" } ``` 然后，您可以在后续的请求头中，包含此身份验证令牌: ``` GET /api/forum HTTP/1.1 Authentication: Token YACub2KLfe8mfmHPcUKtt6t2SMJOGPXnZbqhc3nX ``` 开启 2FA 时，将无法完成请求登录，返回：`401 not_authenticated` ### 获取主题 - 获取所有的讨论（默认排序规则为 -time） `GET /api/discussions` `GET /api/discussions?sort=-commentCount` 按照评论数降序 `GET /api/discussions/:id` 通过 ID 获取讨论 `GET /api/discussions?include=user,lastPostedUser,firstPost,tags` 返回指定内容 ### 创建主题 `POST /api/discussions` ### 用户信息 `GET /api/users/:idOrUsername` 通过 ID 或者用户名获取信息 ### 获取所有组 `GET /api/groups` ### 获取标签 `GET /api/tags`

这个真不错，Hamzone的client做起来了

GET /api/discussions 这个接口有分页参数么？

@"BH5HYR"#p633 如果打开 F12 看的话，其实是可以发现的：https://bbs.hamzone.cn/api/discussions?page[offset]=20 [upl-image-preview url=https://storage.hamcq.cn/2023-03-02/1677736919-785520-image.png] 走的全是标准的 flarum 接口另外，有个微信开发群，会不会更方便对接？

@"BG2LAU"#p1093 怎么感觉是个南+用户（

@"YofoaStudio"#p1095 没看懂您的回复，早安

@"BG2LAU"#p1098 没事没事就是有个资源站留个马克以后可以从回复里面找帖子

HamCQ 社區開放介面

BG5UWQ

本文件仍在更新中…

基本地址

https://forum.hamcq.cn

身分驗證

API 的使用，基於「令牌」的身份驗證機制。

取得 Token

POST /api/token

{
    "識別碼": "Toby",
    "密碼": "pass7word"
}

HTTP/1.1 200 成功

{
    "token": "YACub2KLfe8mfmHPcUKtt6t2SMJOGPXnZbqhc3nX",
    "使用者ID": "1"
}

然後，您可以將此驗證令牌包含在後續的請求標頭中：

GET /api/forum HTTP/1.1
驗證：Token YACub2KLfe8mfmHPcUKtt6t2SMJOGPXnZbqhc3nX

啟用雙重驗證時，將無法完成登入請求，回報：401：未驗證

取得主題 - 取得所有討論 (預設排序規則為 -時間)

取得 /api/discussions

取得 /api/discussions 資料，並按照「commentCount」降序排列。 依照評論數量由多到少排序

取得 /api/discussions/:id 透過 ID 取得討論

取得 /api/discussions 資料，包含 user、lastPostedUser、firstPost 和 tags。 返回指定內容

建立主題

POST /api/discussions

使用者資訊

取得 /api/users/:id或使用者名稱 透過身分識別或使用者名稱取得資訊

取得所有組

取得 /api/groups

取得標籤

取得 /api/tags

BI1NIZ

真不錯，採用「先 API」策略！

bi6mhq

太棒了！

BH5HYR

這確實不錯，Hamzone 的客戶端已經完成了。

BH5HYR

GET /api/discussions 這個 API 是否支援頁面參數？

BG5UWQ

BH5HYR 如果您打開 F12 進行查看，實際上是可以發現的：https://bbs.hamzone.cn/api/discussions?page[offset]=20

所有已完成的，都是標準的 Flarum 介面。

此外，有一個微信開發社群，這樣是不是會更方便合作？

BG2LAU

MARK

YofoaStudio

BG2LAU
感覺像是來自南方的用戶（

BG2LAU

YofoaStudio 我沒有理解您的回覆，早安。

YofoaStudio

BG2LAU
沒事，沒事
就是有個資源網站，先註記一下，之後就可以在回覆中找到相關的文章。

BG2LAU

YofoaStudio 👍👍

BG2LAU

為什麼 F12 無法看到 TOKEN？ Gridtracker 輸入 API，測試失敗。

BG5UWQ

BG2LAU
不是在這裡取得，而是要在個人中心，找到「通聯日誌」處，有一個 API 金鑰。

BG2LAU

BG5UWQ 感謝指導，現在已經完成了。

BI1JBV

還要學習他們的語言嗎？

闽ICP备2021006864号-7

闽公网安备35020602002794号互联网举报中心

用户协议隐私政策社区规范积分规则中继规则转载须知
更新日志联系我们常见问题友情链接运营报告赞助

浩奇科技（厦门）有限公司

是无线电，把我们联系在一起