数据提交接口用于客户端将数据提交至服务端,或者修改已有的服务端数据。
适用于数据提交的请求,例如:用户登录、用户注册、发布文章、发布表单内容等
一、请求地址
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的请求参数了!!!
三、任意页面的相关例子
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编码后传入请求参数中