视频操作教程:https://www.xunruicms.com/doc/video-dev-API%E6%8F%92%E4%BB%B6-%E4%BB%BB%E6%84%8F%E9%A1%B5%E9%9D%A2%E7%9A%84%E6%95%B0%E6%8D%AE%E6%8F%90%E4%BA%A4%E6%8E%A5%E5%8F%A3.html

数据提交接口用于客户端将数据提交至服务端,或者修改已有的服务端数据。

适用于数据提交的请求,例如:用户登录、用户注册、发布文章、发布表单内容等

一、请求地址

1、需要登录时请求地址:

/index.php?appid=[APPID]&appsecret=[appsecret]&api_auth_code=[登录授权码]&api_auth_uid=[用户id]&[任意页面参数]

一般用于用户中心的操作,如修改资料、修改密码、上传头像、发布文章等

2、不需要登录时请求地址:

/index.php?appid=[APPID]&appsecret=[appsecret]&[任意页面参数]

一般用于不需要登录的地方,如匿名提交表单、匿名评论等

二、请求参数

请求参数必须和电脑端保持一致,开发建议首先抓取电脑端修改或提交数据时的POST数据,那么移动端提交时也要满足你抓取的POST数据格式,必须保持一致。

例如,我不知道用户注册时的表单参数怎么办?image.png

在不知道请求参数的情况下,可以利用这个方法来获取请求参数的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=[APPID]&appsecret=[appsecret]&api_auth_code=[登录授权码]&api_auth_uid=[用户id]&s=member&c=account&m=password

请求参数:
is_ajax=1&data[password]=原密码&data[password2]=新密码&data[password3]=再次新密码

返回结果:
修密码接口需要返回新的[登录appsecret],开发者可以重新做本地存储,也可以让用户重新登录。

2、发布文章

请求地址:
/index.php?appid=[APPID]&appsecret=[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=[APPID]&appsecret=[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=[APPID]&appsecret=[appsecret]&api_auth_code=[登录授权码]&api_auth_uid=[用户id]&s=[模块目录]&c=comment&m=post&id=[内容id]

请求参数:
is_ajax=1&content=评论内容&...
这里面的参数一定要和电脑页面的POST参数保持一致

7、模块的评论点赞支持

请求地址:
/index.php?appid=[APPID]&appsecret=[appsecret]&api_auth_code=[登录授权码]&api_auth_uid=[用户id]&s=[模块目录]&c=comment&m=post&id=[内容id]&rid=[评论记录id]&t=zc

8、模块的评论反对

请求地址:
/index.php?appid=[APPID]&appsecret=[appsecret]&api_auth_code=[登录授权码]&api_auth_uid=[用户id]&s=[模块目录]&c=comment&m=post&id=[内容id]&rid=[评论记录id]&t=fd

9、用户中心头像上传

请求地址:
/index.php?appid=[APPID]&appsecret=[appsecret]&api_auth_code=[登录授权码]&api_auth_uid=[用户id]&s=member&c=account&m=avatar
请求参数:
is_ajax=1&file=[base64图片编码格式]

必须在在客户端把图片文件进行base64编码后传入请求参数中

10、网站表单提交

请求地址:
/index.php?appid=[APPID]&appsecret=[appsecret]&api_auth_code=[登录授权码]&api_auth_uid=[用户id]&s=form&c=表单名称&m=post
请求参数:
is_ajax=1&data[title]=...
这里面的参数一定要和电脑页面的POST参数保持一致
文档最后更新时间:2022-03-23 10:01:55
我来修改此文档(3) 不会操作怎么办?