APP开发规范—APP接口开发规范文档V1.0

{天晴 APP 接口规文档}手机客户端接口文档文件状态：[ ] 草稿[√] 正式发布[ ]正在修改文件标识：当前版本：1.0作 者：天晴 完成日期：版 本 历 史版本/状态作者参加者起止日期备注V1.0/草稿磊移动小组目录一、概述 11.1 有关接口 11.1.1 接口是纯数据的交互 11.2 接口的分类 11.2.1 查询类接口 11.2.2 操作类接口 11.2.3 上传下载类接口 11.2.4 推送类接口 1二、查询类接口格式规 12.1 猎取单条对象信息 12.1.1 请求格式 12.1.2 参数说明 22.1.3 正常返回结果 22.2 猎取列表对象信息 22.2.1 请求格式 22.2.2 参数说明 32.2.3 正常返回结果 3三、操作类接口 43.1 新增操作 43.1.1 接口说明 43.1.2 参数说明 43.1.3 正常返回结果 43.1.4 错误返回列表 43.2 修改操作 53.2.1 接口说明 53.2.2 参数说明 53.2.3 正常返回结果 53.2.4 错误返回列表 53.3 删除操作 53.3.1 接口说明 53.3.2 参数说明 63.3.3 正常返回结果 63.3.4 错误返回列表 6四、上传下载类 64.1 上传文件 64.1.1 接口说明 64.1.2 参数说明 74.1.3 正常返回结果 74.1.4 错误返回列表 74.2 下载文件 74.2.1 接口说明 74.2.2 参数说明 74.2.3 正常返回结果 84.2.4 错误返回列表 8五、推送类接口 85.1 推送消息 85.1.1 接口说明 85.1.2 参数说明 85.1.3 正常返回结果 85.1.4 错误返回列表 8六、通用返回格式 96.1 正确返回 96.1.1 接口说明 96.1.2 参数说明 96.1.3 正常返回结果 96.1.4 错误返回列表 96.2 错误返回 96.2.1 接口说明 96.2.2 参数说明 106.2.3 正常返回结果 106.2.4 错误返回列表 10七、附录 107.1 通用错误返回列表 107.2URL 地址信息 117.2.1 主机地址 117.2.2 URL 列表 117.3 安全机制 117.3.1 验证签名机制 117.4 其他 117.2.1 列表数据为空的返回 11一、概述1.1 有关接口1.1.1 接口是纯数据的交互APP 接口是移动设备和业务之间进行通信的途径。实质就是以特定的规则通过接口直接操作数据库的增删改查。1.2 接口的分类1.2.1 查询类接口查询类接口是指客户端传递一些参数，服务端根据参数依据需求，前往数据库查询需要的结果返回数据的一类接口。返回类型一般有两种。第一种是返回一个对象，第二种是返回一个数组对象。第一种比如登陆，客户端把用户名密码上传到接口，服务器返回用户的个人信息。第二种比如猎...