任性网后台系统接口规范V0.8(测试版本,前端初定)分析.doc

任性网社区后台系统 接口规范 修订记录Revision record 日期 Date 修订版本Revision version 修改描述 change Description 作者 Author 2015/05/03 0.80 初稿完成 宋鑫磊 概述 本文档描述了任性网系统中，为了实现整体业务流程，前端之间交互的规范。 传输的网络协议采用http+json格式 用户接口 用户注册 用户前端通过页面访问进行用户设置修改的操作。 接口协议：json 发起方：ios,android 接收方：ios,android 业务ID:100001 输入参数 名称 父接点 描述 是否必填 类型 长度 bizCode 业务ID 是 String 6 userName body 用户唯一ID 否 String 50 userNickName body 用户昵称 是 String 50 portrait body 用户头像地址 是 String 50 实例 输出参数 名称 父接点 描述 是否必填 类型 长度 code RESPONSE 返回结果000000为成功 是 String 6 info RESPONSE 异常信息 是 String 20 根据用户经纬度查询附近的人 用户前端通过页面访问进行用户设置修改的操作。 接口协议：json 发起方：ios,android 接收方：ios,android 输入参数 名称 父接点 描述 是否必填 类型 长度 bizCode 业务ID 是 String 6 longitude body 经度 是 double 20 latitude body 纬度 是 double 20 实例 {bizCode:100002,body:{longitude:2200.11,latitude:2200.011}} 输出参数 名称 父接点 描述 是否必填 类型 长度 resultCode RESPONSE 返回结果00000 为成功 是 String 5 resultInfo RESPONSE 异常信息 是 String 20 userName Result 用户姓名 是 String 20 createDate Result 创建时间 是 String 20 longitude Result 经度 是 double latitude Result 纬度 是 Double userCoin Result 用户金币 是 Double punishCoin Result 积分 是 Int Juli Result 距离我多远，根据传入参数进行判断（米为单位） 是 int 实例 {code:000000,info:成功,result:[{userName:songxinlei,createDate:2015-03-26 22:37:20,longitude:21231.123,latitude:123.23,userCoin:72.0,userRule:1,punishCoin:11,juli:8325546}],map:{}} 客户上报位置 用户前端通过页面访问进行用户设置修改的操作。 接口协议：json 发起方：ios,android 接收方：ios,android 业务ID:100003 输入参数 名称 父接点 描述 是否必填 类型 长度 bizCode 业务ID 是 String 6 userId body 用户唯一ID 是 String 50 longitude body 经度 是 double latitude body 维度 是 double 实例 {bizCode:100003,body:{userId:songxinlei,longitude:21231.123,latitude:123.23}} 输出参数 名称 父接点 描述 是否必填 类型 长度 code RESPONSE 返回结果000000为成功 是 String 6 info RESPONSE 异常信息 是 String 20 添加好友 用户前端通过页面访问进行用户设置修改的操作。 接口协议：json 发起方：ios,android 接收方：ios,android 业务ID：100005 输入参数 名称 父接点 描述 是否必填 类型 长度 bizCode 业务ID 是 String 6 userId body 用户唯一ID 是 String 50 friendId body 好友ID 是 String 50 实例 {bizCode:100005,body:{userId:songxinlei,friendId:songxinlei}} 输