区网上政府采购统一平台应急改造项目API接口.docxVIP

市区网上政府采购统一平台应急改造项目API接口设计说明书目录一、需求背景及概述4二、系统对接帮助文档51、名称解释52、授权服务52.1 获取Access Token52.2 使用Refresh Token 刷新 Access Token83、API调用流程图104、商品API接口114.1 获取商品池编号接口114.2 获取池内商品编号接口114.3 获取商品详细信息接口124.4 获取商品上下架状态接口144.5 获取所有图片信息154.6 商品好评度查询(扩展)165、地址api接口175.1 获取一级地址175.2 获取二级地址175.3 获取三级地址185.4 获取四级地址196、价格API接口196.1 批量查询电商价格197、库存API接口207.1 批量获取库存接口208、订单API接口218.1 预占库存下单接口218.2 确认预占库存订单接口238.3 取消未确认预留库存订单接口248.4 查询电商订单信息接口248.5 查询配送信息接口279、电商API对账接口289.1 新建订单查询接口289.2 获取妥投订单接口299.3 获取拒收消息接口3010、信息推送api接口3110.1 信息推送接口3110.2 根据推送id，删除推送信息接口3211、退换货接口3311.1 申请订单退换货接口3311.2 获取退换货订单信息接口34需求背景及概述API（Application Programming Interface，应用编程接口），简单说就是预先把可能使用到的功能以接口的方式提供出来，就像电源插座一样，只要是两向或者三向插头都可以直接插上，而不用管插头的另一边连的是电脑还是洗衣机。API对接方式的优点有三：接入速度极快下面我们来看一个更贴近我们工作场景的例子：有一个电商，现在想跟深圳网上商城合作，让深圳网上商城可以卖他们的商品。回到以前，深圳网上商城与电商签订相关约束条款，并且深圳网上商城与电商的研发团队要日以继夜的开发好几个月，如果发生需求变更（比如增加个审批流）时间会更长。而现在呢，深圳网上商城只要一个工程师30分钟就可以搞定。客户发展速度极快同样通过举例来说明：相同的研发资源下，某电商正在与深圳网上商城对接时，这时有另外一个电商也要与深圳网上商城对接，业务模式上只是少了订单审批步骤。回到以前，这样的其他电商只能等待当前电商与深圳网上商城对接完成后，再开始根据需求进行开发。等这些完成以后，可能要等待很长的时间深圳网上商城才可以卖他们的商品了。现在通过API可以同时与两个多个电商进行对接，互不影响。极大降低研发成本由于不同电商的数据的类型基本不会变，例如商品信息、订单信息等。不会受到展现方式等条条框框的约束。可以真正做到一次开发，不断复用。通过以上两个极快和一个极大降低可以把原来制约业务发展的两个因素：业务扩展能力和系统研发能力减少到一个因素：业务发展速度只受业务扩展能力的制约。所以大力发展API对接客户模式是极为重要的。系统对接帮助文档名称解释【拆单】：如果一个订单中电商有两个商品分别存放在两个库房，比如说客户购买了一台苹果笔记本和一把尺子。下单后订单就会被拆分为两个子订单下到库房生产。【妥投】：快递员把货送到客户手中并且客户已经签收。【拒收】：快递员把货送到客户手中时，客户由于某种原因拒绝签收该货物，视为拒收。【商品池】：由于电商商品数量太多，对于深圳网上商城而言，获取电商所有商品不现实也没有必要。电商会把每个品类销售排名靠前的sku 加到商品池中，也就是说商品池的放的商品就是客户所能购买的商品范围。授权服务获取Access TokenURL: https://xxx/access_tokenHTTPS请求方式：POST请求参数参数参数选项意义grant_type必须该值固定为access_tokenclient_id必须即创建应用时的client_id (由电商提供)timestamp必须当前调用时间，格式为“2014-01-01 01:01:01”与电商服务器时差不能相差半小时以上，电商服务器时间应为北京时间（年月日和时分秒中间有空格）username必须电商的用户名（注意：在调用电商接口时，如果username是中文，在url参数里面，需要将username使用urf-8格式进行UrlEncode编码，在生成sign签名串时，不需要进行编码，使用原文！）password必须电商的用户密码，必须是md5加密后的字符串，不要使用原文！scope非必须申请权限。（目前推荐为空。为以后扩展用）sign必须签名,生成规则如下：按照以下顺序将字符串拼接起来client_secret+timestamp+client_id+username+password+grant_type+scope+client