平台对接方案下的API根据调用方向可分为两类:①开发者——>顺心捷达②顺心捷达——>开发者。
物流开放平台针对每个对接方案提供了相应的SDK,SDK中封装了当前对接方案下所有API,及API请求逻辑、签名,开发者只需关注业务参数。本文详细介绍了SDK的整个使用流程。
以下单为例,SDK中包含了所有接口的入参和出参定义,入参和出参对象的名称均根据【com.sf.fop.sxjd.oms.open.platform.api.bean.+SX_EWB_ORDER_SAVE(api接口的接口类型)+[Request结尾为请求参数,Response为返回参数]】名称定义
例如:
com.sf.fop.sxjd.oms.open.platform.api.bean.SX_EWB_ORDER_SAVE.EwbOrderSaveRequest下单入参
com.sf.fop.sxjd.oms.open.platform.api.bean.SX_EWB_ORDER_SAVE.EwbOrderSaveResponse下单出参
1、首先创建一个ReceiveSdkHttpServlet继承HttpServlet,把应用信息初始化,把接收地址填入下
2、实现接口监听器,业务逻辑在实现监听器里面
2.1.1 利用顺心开放平台申请的应用信息构造ClientAccount凭证对象
2.1.2 通过ClientAccount构造SxOpenPlatformSdkClient工具类
2.2.1 通过client.SendReadAsObject发送API请求
2.3.1 继承ReceiveListener实现API具体业务
2.3.2 注册ReceiveListener[client.RegisterReceiveListener]
2.3.3 接受到顺心接口请求实体交给client.Receive处理