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

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


一、请求地址

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

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

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


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

/index.php?appid=[授权ID]&appsecret=[授权码]&[任意页面参数]

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


二、请求参数

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

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

在不知道请求参数的情况下,可以利用这个方法来获取请求参数的data字段格式

1、如上图,打开注册页面的电脑界面

2、如上图,开启google浏览器的开发者模式,并切换到Network选项中

3、如上图,在注册表单里面,随便输入一些,不填写验证码(目的是不让他提交,我要看请求参数)

4、点提交按钮,他会提示错误,并停留在这个页面上

5、你可以在开发者模式里面的Network中看到FormData的请求参数了!!!



三、任意页面的相关例子

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编码后传入请求参数中