數據提交接口用於客戶端將數據提交至服務端,或者修改已有的服務端數據。
適用於數據提交的請求,例如:用戶登錄、用戶註冊、發佈文章、發佈表單內容等
一、請求地址
1、需要登錄時請求地址:
/index.php?appid=[授權ID]&appsecret=[授權碼]&api_auth_code=[登錄授權碼]&api_auth_uid=[用戶id]&[任意頁面參數]
一般用於用戶中心的操作,如修改資料、修改密碼、上傳頭像、發佈文章等
2、不需要登錄時請求地址:
/index.php?appid=[授權ID]&appsecret=[授權碼]&[任意頁面參數]
一般用於不需要登錄的地方,如匿名提交表單、匿名評論等
二、請求參數
請求參數必須和電腦端保持一致,開發建議首先抓取電腦端修改或提交數據時的POST數據,那麼移動端提交時也要滿足你抓取的POST數據格式,必須保持一致。
例如,我不知道用戶註冊時的表單參數怎麼辦?
在不知道請求參數的情況下,可以利用這個方法來獲取請求參數的data字段格式
1、如上圖,打開註冊頁面的電腦界面
2、如上圖,開啓google瀏覽器的開發者模式,並切換到Network選項中
3、如上圖,在註冊表單裏面,隨便輸入一些,不填寫驗證碼(目的是不讓他提交,我要看請求參數)
4、點提交按鈕,他會提示錯誤,並停留在這個頁面上
5、你可以在開發者模式裏面的Network中看到FormData的全部請求參數了!!!
終端程序需要將請求參數按照圖中的結構組裝成【數組(一定要是數組)】來提交到迅睿CMS。
例如
微信小程序的提交參數語法:
var postParams = "is_ajax=1"
+"&data[title]=標題"
+"&data[content]=內容內容" // 內容
+"&data[thumb]=999" // 縮略圖id
+"&catid=11";// 欄目11
wx.request({
url: "提交地址api",
data: postParams,
method: 'post',
header: {
'Content-Type': 'application/x-www-form-urlencoded',
},
.....
UniApp的提交參數語法:
uni.request({
method: 'POST',
url: "api提交地址", //接口地址。
data: 'is_ajax=1&data[title]=標題&data[content]=內容&catid=11',
header: {
'content-type': 'application/x-www-form-urlencoded' //自定義請求頭信息
},
......
POST請求格式:https://www.xunruicms.com/doc/1134.html
三、任意頁面的相關例子
1、修改密碼
請求地址:
/index.php?appid=[授權ID]&appsecret=[授權碼]&api_auth_code=[登錄授權碼]&api_auth_uid[用戶id]&s=member&c=account&m=password
請求參數:
is_ajax=1&data[password]=原密碼&data[password2]=新密碼&data[password3]=再次新密碼
返回結果:
修密碼接口需要返回新的[登錄授權碼],開發者可以重新做本地存儲,也可以讓用戶重新登錄。
2、發佈文章
請求地址:
/index.php?appid=[授權ID]&appsecret=[授權碼]&api_auth_code=[登錄授權碼]&api_auth_uid=[用戶id]&s=member&app=news&c=home&m=add
請求參數:
is_ajax=1&data[title]=...
這裏面的參數一定要和電腦頁面的POST參數保持一致
3、表單提交,例如test表單
請求地址:
/index.php?appid=[授權ID]&appsecret=[授權碼]&s=form&c=test&m=post
如果需要登錄才能提交表單,可以加上上面的api參數
請求參數:
is_ajax=1&data[title]=...
這裏面的參數一定要和電腦頁面的POST參數保持一致
4、發佈文章時縮略圖文件如何上傳
首先要通過《文件上傳接口》把文件上傳到服務器,並返回id號;
再把id號存儲到發佈文章的POST表單值中,格式一定要和pc段一致。
5、用戶登錄
https://www.xunruicms.com/doc/411.html
6、模塊評論發佈
請求地址:
/index.php?appid=[授權ID]&appsecret=[授權碼]&api_auth_code=[登錄授權碼]&api_auth_uid=[用戶id]&s=[模塊目錄]&c=comment&m=post&id=[內容id]
請求參數:
is_ajax=1&content=評論內容&...
這裏面的參數一定要和電腦頁面的POST參數保持一致
7、模塊的評論點贊支持
請求地址:
/index.php?appid=[授權ID]&appsecret=[授權碼]&api_auth_code=[登錄授權碼]&api_auth_uid=[用戶id]&s=[模塊目錄]&c=comment&m=post&id=[內容id]&rid=[評論記錄id]&t=zc
8、模塊的評論反對
請求地址:
/index.php?appid=[授權ID]&appsecret=[授權碼]&api_auth_code=[登錄授權碼]&api_auth_uid=[用戶id]&s=[模塊目錄]&c=comment&m=post&id=[內容id]&rid=[評論記錄id]&t=fd
9、用戶中心頭像上傳
請求地址:
/index.php?appid=[授權ID]&appsecret=[授權碼]&api_auth_code=[登錄授權碼]&api_auth_uid=[用戶id]&s=member&c=account&m=avatar
請求參數:
is_ajax=1&file=[base64圖片編碼格式]
必須在在客戶端把圖片文件進行base64編碼後傳入請求參數中
10、網站表單提交
請求地址:
/index.php?appid=[授權ID]&appsecret=[授權碼]&api_auth_code=[登錄授權碼]&api_auth_uid=[用戶id]&s=form&c=表單名稱&m=post
請求參數:
is_ajax=1&data[title]=...
這裏面的參數一定要和電腦頁面的POST參數保持一致