通视接口规范

通视接口规范篇一：APP 接口开发规范文档 北京天晴 APP 接口规范文档 手机客户端接口文档 版 本 历 史目录 一、概述.1 有关接口 .1 接口是纯数据的交互 . 1 接口的分类 .1 查询类接口 .1 操作类接口 . 1 上传下载类接口 . 1 推送类接口 .1 二、查询类接口格式规范 . 1 获取单条对象信息 . 1 请求格式 . 1 参数说明 .2 正常返回结果 .2 获取列表对象信息 . 3 请求格式 . 3 参数说明 .3 正常返回结果 .3 三、操作类接口 . 4 新增操作 .4 接口说明 .4 参数说明 .4 正常返回结果 .4 错误返回列表 .5 修改操作 .5 接口说明 .5 参数说明 .5 正常返回结果 .5 错误返回列表 .5 删除操作 .6 接口说明 .6 参数说明 .6 正常返回结果 .6 错误返回列表 .6 四、上传下载类 . 7 上传文件 .7 接口说明 .7 参数说明 .7 正常返回结果 .7 错误返回列表 .7 下载文件 .7 接口说明 .7 参数说明 .8正常返回结果 .8 错误返回列表 .8 五、推送类接口 . 8 推送消息 .8 接口说明 .8 参数说明 .8 正常返回结果 .9 错误返回列表 .9 六、通用返回格式 . 9 正确返回 .9 接口说明 .9 参数说明 .9 正常返回结果 .9 错误返回列表 . 10 错误返回 .10 接口说明 .10 参数说明 .10 正常返回结果 . 10 错误返回列表 . 10 七、附录.11 通用错误返回列表 .11 URL 地址信息 .11 主机地址 . 11 URL 列表 . 11 安全机制 .11 验证签名机制 .11 其他 .12 列表数据为空的返回 .12 一、概述 有关接口 接口是纯数据的交互 APP 接口是移动设备和业务之间进行通信的途径。实质就是以特定的规则通过接口直接操作数据库的增删改查。接口的分类 查询类接口 查询类接口是指客户端传递一些参数，服务端根据参数依据需求，前往数据库查询需要的结果返回数据的一类接口。 返回类型一般有两种。第一种是返回一个对象，第二种是返回一个数组对象。 第一种比如登陆，客户端把用户名密码上传到接口，服务器返回用户的个人信息。 第二种比如获取客户，客户端把用户的身份信息上传到接口，服务器返回此身份下的所有客户数组集合。 操作类接口 操作类接口是指，客户端通过接口进行一些增删改的操作。比如新增一个客户，修改客户信息，或者删除一个客户。服务器一般返回执行的状态，有的需要返回执行结果的一些信息，比如新增客户后，返回客户的 ID。 上传下载类接口 上传下载类接口是涉及到文件传输的接口。比如上传头像，需要上传图片到服务器，服务端根据需求响应保存并返回结果。比如客户端需要显示用户头像，需要读取网络图片文件，在手机上进行显示。 推送类接口 除了客户端主动去请求服务端，获取需要信息之外。有时候，也存在服务端有消息需要通知客户端的情况，这时候就是服务端向客户端发送消息。这类需求可以通过客户端短时间类循环请求解决，也可以通过第三方专业推送解决。也可以通过自己使用 socket 或者 xmpp 等协议进行开发。 二、查询类接口格式规范 获取单条对象信息 请求格式 1篇二：通视问题例谈地形图中的通视问题 在等高线地形图中，判断两点之间能否通视主要看两个方面：一是看两点间有无山脊阻挡，无山脊阻挡则可以通视；二是看两点间是凸坡还是凹坡。若等高线上密下疏，则坡度上陡下缓，为一个凹坡，可以通视。若等高线上疏下密，则坡度上缓下陡，为一个凸坡，不能通视。通视问题既可以通过看等高线的形状来判断，也可以通过作地形剖面图来解决。 例 1、下图为某区域图，从甲点能够看到乙、丙、丁、戊 四点中的（ ） A乙点 B丙点 C丁点 D戊点 解析：能看见丙点。甲点和丁点、戊点之间有山脊阻碍视线，故看不见丁点和戊点；甲乙之间为凸坡（从甲到乙先缓后陡） ，故看不见；而甲丙之间为凹坡（从甲到丙先陡后缓） ，能看见。答案是 B。 例 2.游客被困在下图所示山区，此时正值雨季，多岩崩和泥石流等地质灾害。读该地等高线地形图，救护直升机停靠在山顶 H 处，被困游客位于甲、乙、丙、丁四点中某一位置，则救护人员能够直接观测到的点是( ) A.甲点 B.乙点 C.丙点 D.丁点 解析：可分别画出从 H 点到甲、乙、丙、丁四点的地形剖面图（见下图） ，H 与甲之间有山脊，与丁之间有凸坡，与丙之间有陡崖，阻碍视线，不能通视。只有 H 与乙之间为一个凹坡，可以通视。答案是 B。 篇三：BOSS 的接口规范中国移动 BOSS 系统接口规范 Internet 接入部分 (Version ) 中国移动通信集团公司 二一年八月 目 录 1. 2. 3. 总则 . 1 概述 . 1 原则和目标 .1 适用范围 .2 起草单位 .2 解释权 .2 接入服务接口总体说明 .3 系统总体接口应用模型 .3 接口实现机制 .4 接口要求 .6 Internet 接口说明 . 7 接口应用模型 .7 接口网络组织 .8 接口安全控制 .10 安全评估 .10 访问控制 .11 入侵检测 .12 口令认证 .12 安全审计 .12 防（毒）恶意代码 .12 加密 . 13 其他 . 13 接口连接管理 .14 传输控制 .14 通讯服务 .14 动态资源管理 .15 目录 1 中国移动通信集团公司 4.接口逻辑管理 .16 数据管理 .16 业务数据检查 .16 数据压缩/解压 . 16 优先级管理 .(转载于: 小 龙文档 网:通视接口规范). 17 交换分发管理 .17 完整性管理 .18 实时交易业务 .19 批量传输业务 .19 接口服务详述 .20 业务受理 .20 功能界定 .20 售不记名卡 .21 业务描述 .21 接口服务 .21 不记名卡查询接口服务 .21 不记名卡销售接口服务 .21 卡销售回退接口服务 .21 预销 . 22 业务描述 .22 接口服务 .22 预销初始接口服务 .22 预销确认接口服务 .22 用户资料变更 .22 业务描述 .22 接口服务 .23 密码验证接口服务 .23 资料查询接口服务 .23 用户服务密码变更接口服务 .23 客户信息资料变更接口服务 .24 帐户信息资料变更接口服务 .24服务变更 .25 业务描述 .25 接口服务 .25 服务变更初始接口服务 .25 号源查询接口服务 .25 业务选择接口服务 .26 服务变更费用计算接口服务 .26 服务变更确认接口服务 .26 付费计划变更 .27 业务描述 .27 接口服务 .27 付费计划变更初始接口服务 .27 付费计划变更接口服务 .27 客户化帐单格式变更接口服务 .27 套餐计划变更