手机api
来自Blueidea
全局result错误码说明
错误代码 错误描述 0 表示请求成功 -101 系统错误 -102 服务暂停 -103 必须传递的参数不存在或者不正确 -104 请求的api地址不存在
目录
登陆接口
请求地址:http://192.168.1.5/tch/api/login
请求方式:POST
请求参数:
参数名称 必选 类型及范围 说明 devicetoken true string 设备token(des加密),确定用户的设备是否有使用过 username true string des加密手机号码 authcode true string 密码经过des加密后的字符串
返回结果:JSON格式
参数名称 类型及范围 说明 result int -1:用户不存在,或者被删除;
-2:用户名或者密码不正确data array 用户信息
{ "result":0, "data":{}// 用户信息 }
登出接口
请求地址:http://192.168.1.5/tch/api/logout
请求方式:POST
请求参数:
参数名称 必选 类型及范围 说明 mobile true string 用户手机号(des加密)
返回结果:JSON格式
{ "result":0 }
手机邀请码发送接口
请求地址:http://192.168.1.5/tch/api/sms_invite
请求方式:POST
请求参数:
参数名称 必选 类型及范围 说明 mobile true string des加密后的手机号码
返回结果:JSON格式
参数名称 类型及范围 说明 result int -1:手机号码格式不正确;
-2:发送邀请短信失败
-3:手机号码已经被邀请注册
-4:未知的手机号,不能提供发邀请码的服务,重填.
-5:手机已经被列入黑名单列表,如需解除请联系客服QQ800003860或手机号码*****data array 发送完成反馈信息
{ "result":0, "data":{ 'attribution':'',// 手机归属地 'operators':'',// 手机运营商 'invitecode':'' // 生成的邀请码(经过加密处理) } }
获取家长的所有小孩和班级
请求地址:http://192.168.1.5/tch/api/getchilds
请求方式:POST
请求参数:
参数名称 必选 类型及范围 说明 username true string 家长用户手机号(des加密)
返回结果:JSON格式
{ "result":0, "data":{ // 所有小孩 "childs":[{ sid:0,// 学生id cid:0,// 小孩所在班级id relcode:"父亲",// 家长称呼, studentname:"",// 学生姓名 }], // 所有班级 "classes":[{ mastername:0,// 班主任名称 cid:0,// 班级id cname:"",// 班级名称 schid:"",// 学校id schname:"",// 学校名称 }] } }
密码修改接口
请求地址:http://192.168.1.5/tch/api/updatepwd
请求方式:POST
请求参数:
参数名称 必选 类型及范围 说明 username true string des加密的手机号码 oldpwd true string des加密的旧密码 newpwd true string des加密的新密码
返回结果:JSON格式
参数名称 类型及范围 说明 result int 0:更新成功
-1:没有做任何修改
-2:旧密码不正确
-3:用户不存在或者被删除
{ "result":0 }
用户信息读取
请求地址:http://192.168.1.5/tch/api/getuser
请求方式:POST
请求参数:
参数名称 必选 类型及范围 说明 uid true int 用户id
返回结果:JSON格式
{ "result":0, "data":{ username, // 用户名 realname, // 真是姓名 age, // 年龄 birthyear, // 生日年份 birthmonth, // 生日月份 birthday, // 生日是哪天 .... } }
获取单条帖子信息
请求地址:http://192.168.1.5/tch/api/getthread
请求方式:POST
请求参数:
参数名称 必选 类型及范围 说明 tid true int 主题id
返回结果:JSON格式
参数名称 类型及范围 说明 result int 0:更新成功
-1:帖子不存在或者被删除
-2:帖子已经关闭
{ "result":0, "data":{ tid:'',// 主题id clsid:'',// 所属班级id clsname:'',// 班级名称 authorid:'',// 作者id author:'',// 作者用户名 subject:'', // 标题 message:'', // 帖子内容 dateline:'', // 发表时间 lastpost:'', // 最后发表 lastposter:'',// 最后发表人 } }
获取多条帖子信息
请求地址:http://192.168.1.5/tch/api/get_many_post
请求方式:POST
请求参数:
参数名称 必选 类型及范围 说明 clsid false int 班级id startid true int 起始id number true int 获取多少条 order true string 排序字段(可以逗号分隔,如id asc,name desc)
返回结果:JSON格式,status=0表示操作成功
{ "result":0, "data"[{ id:'', clsid:'',// 所属班级id clsname:'',// 班级名称 authorid:'',// 作者 author:'',// 作者姓名 useip:'',// 发帖者IP subject:'', // 标题 message:'', // 帖子内容 dateline:'', // 发表时间 lastpost:'', // 最后发表 lastposter:'',// 最后发表人 views:'',// 浏览次数 replies:'',// 回复次数 displayorder:'',// 显示顺序 highlight:'',// 是否高亮 digest:'',// 是否精华 },{},{}] }
获取用户班级信息
请求地址:http://192.168.1.5/tch/api/get_user_class
请求方式:POST
请求参数:
参数名称 必选 类型及范围 说明 uid false int 用户id
返回结果:JSON格式
{ "result":0, "data":[{ clsid:'',// 班级id clsname:'',// 班级名称 grade:'',// 所属年级 areaname:'',// 所在城市区域 schname:'',// 学校名称 dateline:''// 班级创建时间 },{}] }
注册手机设备的uuid
请求地址:http://192.168.1.5/tch/api/register_device
请求方式:POST
请求参数:
参数名称 必选 类型及范围 说明 devicetoken true string 设备的token(des加密) type true string 设备的类型(1:IOS,2:Android) pushtype true int 推送平台的类型(1:信鸽,2:极光) pushtoken true string 推送平台的token(des加密) os true string 手机OS osversion true string 手机OS版版本
返回结果:JSON格式
{ "result":0 }