“手机api”的版本间的差异

来自Blueidea
跳转至： 导航、 搜索
（→‎获取用户班级信息）
第293行： 第293行：
 
       dateline:''// 班级创建时间
 
       dateline:''// 班级创建时间
 
     },{}]
 
     },{}]
 +
}
 +
</source>
 +
 +
== 获取手机设备的uuid ==
 +
'''请求地址'''：http://192.168.1.5/teach/api/get_device_uuid<br>
 +
'''请求方式'''：POST<br>
 +
'''请求参数'''：
 +
:{| class="wikitable" style="font-size:13px;"
 +
! 参数名称
 +
! 必选
 +
! 类型及范围
 +
! 说明
 +
|-
 +
!scope="row"|deviceid
 +
| true|| string|| 设备唯一id
 +
|-
 +
!scope="row"|type
 +
| true|| string|| 设备类型
 +
|-
 +
!scope="row"|os
 +
| true|| string|| os名称
 +
|-
 +
!scope="row"|osversion
 +
| true|| string|| os版本
 +
|}
 +
'''返回结果'''：JSON格式
 +
<source lang="javascript">
 +
{
 +
    "result":0,
 +
    "data":{
 +
      uuid:'',// 设备唯一id
 +
    }
 
}
 
}
 
</source>
 
</source>

2014-07-29T10:44:09的版本

返回格式说明 

 "result":0,// (0:表示成功,负数表示传入参数有错，正数表示服务器执行出现错误,错误码请参见下面的错误代码)
 "data":{} // 具体的业务数据

错误码说明

错误代码 错误描述
1 系统错误
2 服务暂停
3 用户名不存在
4 登陆验证错误
-1 非法请求地址(地址不存在)
-2 非法请求参数(参数可能包含非法字符)

登陆接口

请求地址：http://192.168.1.5/teach/api/login
请求方式：POST
请求参数：

参数名称 必选 类型及范围 说明
username true string 用户名或者email
authcode true string 密码经过md5加密后的字符串

返回结果：JSON格式 

{
    "result":0,         
    "data":{}// 用户信息
}

登出接口

请求地址：http://192.168.1.5/teach/api/logout
请求方式：POST
请求参数：

参数名称 必选 类型及范围 说明
username true string 用户名或者email

返回结果：JSON格式 

{
    "result":0
}

密码修改接口

请求地址：http://192.168.1.5/teach/api/updatepwd
请求方式：POST
请求参数：

参数名称 必选 类型及范围 说明
username true string 用户名或者email
oldpwd true string md5加密的旧密码
newpwd true string md5加密的新密码

返回结果：JSON格式 

{
    "result":0
}


用户信息读取

请求地址：http://192.168.1.5/teach/api/getuser
请求方式：POST
请求参数：

参数名称 必选 类型及范围 说明
uid true int 用户id

返回结果：JSON格式 

{
    "result":0,
    "data":{
        username, // 用户名
        realname, // 真是姓名
        age,   // 年龄
        birthyear, // 生日年份
        birthmonth, // 生日月份
        birthday, // 生日是哪天
        ....
    }
}

用户资料修改(还未完成)

请求地址：http://192.168.1.5/teach/api/updateuser
请求方式：POST
请求参数：

参数名称 必选 类型及范围 说明
uid true int 用户id
type true string 分类('base'-->基本信息,'contact'-->联系方式,'edu'-->教育情况,'work'-->工作情况,'info'-->个人信息)
profile true array 针对type字段，相对应的信息

返回结果：JSON格式 

{
    "result":0
}

推送接口地址

请求地址：http://192.168.1.5/teach/api/push
请求方式：POST
请求参数：

参数名称 必选 类型及范围 说明
token true string push平台的token
appid true string push平台的appid
apikey true string push平台的apikey
secretkey true string push平台的secretkey
id true string push平台的id
name true string push平台的name

返回结果：JSON格式,status=0表示操作成功 

{
    "result":0
}

获取单条帖子信息

请求地址：http://192.168.1.5/teach/api/get_signal_thread
请求方式：POST
请求参数：

参数名称 必选 类型及范围 说明
tid true string 帖子ID

返回结果：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/teach/api/get_many_thread
请求方式：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/teach/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/teach/api/get_device_uuid
请求方式：POST
请求参数：

参数名称 必选 类型及范围 说明
deviceid true string 设备唯一id
type true string 设备类型
os true string os名称
osversion true string os版本

返回结果：JSON格式 

{
    "result":0,
    "data":{
       uuid:'',// 设备唯一id
    }
}
取自“http://wiki.blueidea.com/index.php?title=手机api&oldid=9740”