任意頁面的數據提交接口

數據提交接口用於客戶端將數據提交至服務端,或者修改已有的服務端數據。

適用於數據提交的請求,例如:用戶登錄、用戶註冊、發佈文章、發佈表單內容等

 

一、請求地址

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參數保持一致

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章