8宝农业信息服务系统用户接口需求文档.doc

8宝农业信息服务系统用户接口需求文档 版本V1.0访问协议http协议传递数据方式Json封装传递 用户激活与用户中心模块 接口名方法名方法参数说明/备注返回参数说明接口测试链接获取登陆sdkkeyLogin()无返回String sdkKey 通过sdkKey去服务端获取用户信息检测用户是否初始化checkUserExist(string sdkKey) sdkKey sdk返回的唯一特殊字串返回用户信息User user 如果用户信息不存在，去服务端用户心中取用户信息，并需要初始化用户信息，如果存在，直接进入系统没有初始化化,去另外服务器获取用户信息getUserInfo(string sdkKey) sdkKey sdk返回的唯一特殊字串返回用户信息User user 供用户初始化信息初始化时,保存用户信息saveInitUserInfo（User user）user用户信息 返回Boolean ：true/false 进入我的农场 用户中心更新用户信息updateUserInfo (User user) user用户信息 返回Boolean ：true/false 根据用户id查询用户信息queryUserInfo(int userId)userId 用户id返回用户信息User user 农作物部分 土地管理模块 接口名方法名方法参数说明/备注返回参数说明接口测试链接添加土地引导addLandGuide(int userid)； svn int userid 用户id 返回返回Boolean ：true/false 当用户第一次进入种植场，需要添加引导，引导用户添加用户土块，非第一次进入养殖场直接进入项目管理模块 根据用户id查询使用或未使用土地信息queryLandInfo (string state int userid)string state state代表已使用/未使用状态返回 ListLand 已使用/或未使用集合根据用户id查询所有土地信息queryAllLandinfol(int userid)int userid 用户id返回 ListLand 所有土地集合删除某土块信息delLandInfo(int landId) int landId： 土块id返回Boolean ：true/false添加土块信息addLand(Land land)； Land land某一个土块信息，包括用户id返回Boolean ：true/false土地出租rendLand(Land land)； Land land某一个土块信息，包括用户id返回Boolean ：true/false 土地出租成功后，土地项目状态改为出租，出租土地用户不能添加项目测土申请模 接口名方法名方法参数说明/备注返回参数说明接口测试链接给地块创建测土申请CreateTestLandApply(Apply apply ) Apply apply 地块的申请返回Boolean ：true/false 添加成功后，测土申请记录不能删除，供专家查看查询指定地块申请信息queryTestLandApply(int landid) int landed 土地id返回指定的Apply apply查询用户全部地块申请信息queryAllTestLandApplys(int userId) int userId 用户id返回用户 ListApply 所有土地集合更新某土块申请信息updateTestLandApply(Apply apply) Apply apply： 地块的申请返回Boolean ：true/false 农作物选项目模块 接口名方法名方法参数说明/备注返回参数说明接口测试链接获取用户推荐项目getRecommendPlantProjects(int areaI，int curPage，int perPageNum) Int areaId用户区域id； int curPage：当前页； int perPageNum：每页数量；返回系统推荐给用户的项目ListProject 用户进入选项目界面，未通过查询条件查询项目时可以查看系统默认推荐项目根据项目名，查询项目queryPlantProjectsByPName（int areaId，String pName）//项目名，地区 Int areaId用户区域id； String pName项目名