设备端需要实现的标准

更新时间：2018-06-08 14:43:55

共享商用设备有以下几种租赁方式

• 售：自动售卖机、咖啡机

• 租：共享单车、共享充电宝

• 享：共享按摩椅

为了标识共享设备上的货物，系统对共享设备上的货物进行了抽象，每一个共享设备都有一个二维的格子。

如果像咖啡机这种只有一维的几种咖啡也可以用 n*1来表示。

每一种设备类型接入共享商用平台实现货物的购买或使用，有几个必须的服务要实现

售卖类型

标准服务

同步服务，批量库存查询：listInventory

上报设备最新全部的库存情况

入参：无

出参：{"inventoryDetail":</span>[{"x":1,"y":1,"c":2},{"x":2,"y":2,"c":0}]}，inventoryDetail:库存详情，json格式的字符串</span>数组。c代表具体数字就是具体的库存数量，0就是没有

同步服务，单个库存查询：getInventory

上报设备最新的库存情况

入参：int x,int y 分别是二维格式的横坐标、纵坐标

出参：{"c":2}。c代表具体数字就是具体的库存数量，0就是没有

异步服务，出货：deliverCommodity

当用户在手机上支付后，设备根据用户购买的货物出货

入参：int x,int y,int quantity,String orderNo。 x,y分别是二维格式的坐标，quantity 下单的数量，orderNo是订单号
出参： {"result":"1","code":""} result 1是成功，0是失败,如果是0，code就是具体的错误码

异步服务，增加库存：addInventory

当运维人员增货后，可以增加库存

入参：int x,int y,int c 分别是二维格子的横坐标、纵坐标，数量
出参： {"result":"1","code":""} result 1是成功，0是失败,如果是0，code就是具体的错误码

标准事件

订单出货事件：deliverCommodityEvent

要求：QOS1，不能丢消息
参数：String orderNo,long deliverTime,String result,String code
orderNo是订单号，deliverTime是出货的时间，result 1是成功，0是失败,如果是0，code就是具体的错误码

数值范围