Discuz! 官方交流社區(qū)
標(biāo)題: 使用Discuz! X5的RESTful API實(shí)現(xiàn)登錄、注冊(cè)、獲取版塊列表、帖子列表、帖子詳情頁 [打印本頁]
作者: 有愛設(shè)計(jì) 時(shí)間: 2025-9-24 15:18
標(biāo)題: 使用Discuz! X5的RESTful API實(shí)現(xiàn)登錄、注冊(cè)、獲取版塊列表、帖子列表、帖子詳情頁
本帖最后由 有愛設(shè)計(jì) 于 2025-9-24 19:10 編輯
1. 準(zhǔn)備工作1、進(jìn)入你的網(wǎng)站后臺(tái)--站長--RESTful 接口--應(yīng)用列表
新增應(yīng)用-填寫應(yīng)用名稱，提交后會(huì)得到以下信息，保存好你的appid和secret
2、進(jìn)入你的網(wǎng)站后臺(tái)--站長--RESTful 接口--接口列表
打開https://gitee.com/Discuz/discuz-restful-api，下載這個(gè)git文件,
點(diǎn)擊導(dǎo)入接口。選擇本地安裝-上傳文件，在下面的選擇文件中選擇已下載的文件“discuz_restful_official_trial.xml”，點(diǎn)擊提交。這樣你的接口列表中就會(huì)有默認(rèn)的一些接口了，接下來介紹怎么通過接口實(shí)現(xiàn)登錄。
2. 開始開發(fā)接下來的示例以php作為演示，如果有其他的語言，可以參考此實(shí)例；
1、使用appid、secret、接口url（http://dz.local:8080/api/restful/?token）獲取token,獲取函數(shù)參考此實(shí)例中的_request函數(shù)
2、獲取到的token需要自己存儲(chǔ)，用于請(qǐng)求下一個(gè)接口時(shí)使用；
其余的接口請(qǐng)求可參考具體的附件
參考文件中的邏輯關(guān)系梳理
1. 初始化和 Token 獲取程序首先創(chuàng)建 request 類實(shí)例并調(diào)用 getToken() 方法。
getToken() 方法檢查 session 中是否已有有效的 token（有效期 2 小時(shí)）。
如果沒有有效 token 或已過期，則通過 _request('/token', []) 請(qǐng)求新的 token。
獲取到的 token 會(huì)被保存到 session 中供后續(xù)使用。
2. 主菜單顯示成功獲取 token 后，調(diào)用 showMenu() 方法顯示操作界面。
界面包括：
Token 信息展示（token 值、獲取時(shí)間、過期時(shí)間）
用戶登錄狀態(tài)檢查
根據(jù)登錄狀態(tài)顯示登錄表單或用戶信息
API 測(cè)試菜單（僅在登錄后可用）
3. 用戶認(rèn)證流程登錄流程
用戶填寫用戶名和密碼提交登錄請(qǐng)求
如果需要驗(yàn)證碼（由 getSeccode() 提供），用戶還需輸入驗(yàn)證碼
調(diào)用 login() 方法發(fā)送登錄請(qǐng)求到 /member/login
登錄成功后將用戶信息保存到 session，并清除驗(yàn)證碼狀態(tài)
注冊(cè)流程
用戶點(diǎn)擊注冊(cè)鏈接觸發(fā) showRegisterForm() 方法
該方法先調(diào)用 /member/registerInfo 獲取注冊(cè)所需字段信息
顯示包含動(dòng)態(tài)字段的注冊(cè)表單（用戶名、密碼、郵箱、驗(yàn)證碼等）
用戶提交后，register() 方法收集表單數(shù)據(jù)并調(diào)用 /member/register 完成注冊(cè)
4. 驗(yàn)證碼處理登錄驗(yàn)證碼：通過 getSeccode() 方法獲取，調(diào)用 /seccheck/seccode 接口
注冊(cè)驗(yàn)證碼：通過 getRegisterSeccode() 方法獲取，同樣調(diào)用 /seccheck/seccode 接口
驗(yàn)證碼圖片以 base64 編碼形式返回并在前端顯示
5. API 接口測(cè)試登錄后可以測(cè)試以下接口：
獲取版塊列表 (getForumlist())：調(diào)用 /index/forumlist 接口
獲取帖子列表 (getForumDisplay())：調(diào)用 /forumdisplay 接口
獲取帖子詳情 (getViewthread())：調(diào)用 /viewthread 接口
所有 API 調(diào)用都通過 _request() 方法發(fā)送，該方法負(fù)責(zé)：
生成請(qǐng)求頭（appid、nonce、timestamp、signature）
添加 token（如果存在）
發(fā)送 HTTP POST 請(qǐng)求
返回解碼后的 JSON 響應(yīng)
6. 會(huì)話管理程序使用 PHP session 存儲(chǔ)以下信息：
token 及其獲取時(shí)間
用戶登錄信息及登錄時(shí)間
注冊(cè)字段信息
驗(yàn)證碼狀態(tài)和 hash 值
7. 退出和清理logout() 方法清除所有 session 數(shù)據(jù)并重定向到首頁
"清除 Token" 按鈕可手動(dòng)清除 token 和相關(guān) session 數(shù)據(jù)
作者: monkeye 時(shí)間: 2025-9-24 15:19
沙發(fā)
作者: 科站網(wǎng) 時(shí)間: 2025-9-24 15:29
板凳
作者: 人工智能實(shí)驗(yàn)室 時(shí)間: 2025-9-24 16:11
頂起
作者: 湖中沉 時(shí)間: 2025-9-24 17:09
站位必須靠前
作者: wicool 時(shí)間: 2025-9-25 10:02
頂頂頂頂頂
| 歡迎光臨 Discuz! 官方交流社區(qū) (http://r615.cn/) |
Powered by Discuz! X5.0 |