华阳提供给线下ERP接口文档.docxVIP

erp接口服务说明 总体说明 接口提供方式：接口以HTTP的方式提供。 数据格式：ERP中间件响应的数据统一为JSON格式。 编码：UTF-8 HTTP method：全部接口都以POST方式提供。 接口地址： /rest/**** 每日访问次数限制：50000 接口调用 所有的接口都以http post方式提供。ERP中间件响应的内容为json格式，UTF-8编码，参数应以http parameter的方式传送给ERP中间件。 一个正常的响应示例： {"result":{"accessToken":"glZbo+zFsQ1678SeCleO9PdBCww=","expiresIn":7200},"success":true} 一个异常的响应示例： {"exceptionInfo":{"exceptionMessage":"未找到对应的订单","exceptionType":"未找到对象","exception":"ObjectNotFoundException"},"success":false} 其中，success字段表示接口是否调用成功，成功时值为true，失败时值为false。当成功时，响应中会包含result字段，这个字段是业务接口的返回值。当失败时，响应中会包含exceptionInfo字段，可以根据exceptionInfo来判断错误的类型，有助于调整您的程序代码。 exceptionInfo中的exception字段表示了异常的类型（可以理解为错误代码），目前常见的有以下几种： AccessExceedException：接口访问次数超出限额 AccessTokenInvalidException：无效的AccessToken AccessTokenNotFountException：未获取AccessToken MethodNotAllowedException：HTTP METHOD错误 ObjectNotFoundException：未找到对象 ParameterBindingException：参数绑定错误 ParameterExceedException：参数超出范围 ParameterEmptyException：参数空错误 ParameterTypeMismatchException：参数类型错误 PermissionRefusedException：越权操作 UncategorizedException：未分类的异常 如果出现的异常不在上述分类当中，则可能是ERP中间件内部发生了异常，请联系华阳信通公司。 基本的参数及返回值的类型： String:字符串。 int\Integer:整型数字。如果没有特别说明，一般应当大于或等于0。 Double:浮点型数字。如果没有特别说明，一般应当大于或等于0。 Boolean:布尔型。true或false Date:日期型。实际接口中以String型代替，格式为yyyy-MM-dd HH:mm:ss 查询商家商品分类列表 接口请求说明 调用地址 接口地址/rest/egoods/querySorts 方法描述 查询商家商品分类列表（分页） 请求参数描述 参数 名称 类型 允许为空 备注 accessToken String N sortId 商品分类id Long Y 接口响应说明 正常响应示例： 响应参数描述 参数 名称 类型 参考值 备注 result 响应消息 json success 成功标示 String hassub 是否有子项 Boolean level 分类级别 Integer seq 排序字段 Long children 子级分类集合 json parentid 父级分类id Long sortname 分类名称 String shopname 商家名称 String sortsid 分类id Long 查询商家商品列表 接口请求说明 调用地址 接口地址/rest/egoods/queryGoodsPage 方法描述 查询商家商品列表（分页） 请求参数描述 参数 名称 类型 允许为空 备注 accessToken String N sortId 商品分类id Long Y goodsIds 商品id集合 String Y 接口响应说明 正常响应示例： 响应参数描述 参数 名称 类型 参考值 备注 result 响应消息 json success 成功标示 String total 商品库存 Integer salestotal 销售量 Integer statusname 商品中文状态 String status 商品状态 Integer 未上架=0 已上架=1 已下架=2 minmarket 最低市场价格 Doub