茂阳
  1. 开发入门
茂阳
  • 蔬东坡开放平台API文档
    • 什么是蔬东坡开放平台
    • 开发入门
      • API调用协议
      • 签名生成规则
    • 基础数据接口
      • 获得全部站点
      • 发货时间段列表
      • 用户类型列表
      • 商品分类列表
      • 获得全部仓库
      • 业务员新增
      • 获取采购员、供应商数据
      • 区域列表
      • 供应商新增
      • 商品单位列表
      • 业务员列表
    • 库房
      • 订单发货出库
      • 批次库存列表
    • 商品
      • 商品标签
      • 编辑商品分类
      • 新增商品分类
      • 删除商品分类
      • 新建商品
      • 搜索商品
      • 更新商品
    • 订单
      • 新增实收变更
      • 订单标签
      • 查询实收变更详情
      • 订单商品标签查询
      • 搜索订单
      • 批量创建订单
      • 新建订单
      • 完成订单
      • 订单关闭
      • 获取配送信息
    • 采购单
      • 新增采购单
      • 采购单收货
      • 采购单查询
      • 编辑采购单
    • 客户协议价
      • 客户类型列表
      • 协议价详情
      • 客户协议价列表
    • 客户
      • 获取下单商品信息
      • 获取线路列表
      • 新增客户
      • 获取集团列表
      • 搜索客户
    • 异步通知
      • 通知参数说明
    • 订单-退货单
      • 退货单列表
      • 退货单详情
      • 创建退货单
      • 审核拒绝退货单
    • 商品-溯源
      • 查询商品溯源
    • 出、入库单查询
      • 入库单查询
      • 出库单查询
    • 客户类型
      • 获得可下单商品列表
    • 现有库存查询
      • 现有库存查询
    • 库房-分拣
      • 分拣条形码获取订单明细
    • 采购-退货单
      • 搜索采购退货单
      • 保存采购退货单
    • 财务
      • 采购结算单列表
      • 客户结算单列表
  1. 开发入门

签名生成规则

签名算法#

为了防止API调用过程中被黑客恶意篡改,调用任何一个API都需要携带签名,服务端会根据请求参数,对签名进行验证,签名不合法的请求将会被拒绝。目前支持的签名算法是:MD5(sign_method=md5)签名大体过程如下
所有请求参数(包括appid,timestamp)根据key值的字母升序排序后,以key1value1key2value2。。。的方式连接在最后加上secret(由服务端分配唯一的密钥参数,PS:不参与通信)组成的字符串
把拼装好的字符串采用utf-8编码,使用MD5对字符串加密转后为大写得到sign(签名)
#请求实例
如要请求的api为 /openApi/commodity/list
api需要传的业务参数为:provider_id,commodity_id
step1:生成时间戳
step2:根据参数生成sign
string=appidxxxcommodity_idxxxprovider_idxxxtimestamp1511332935secret
然后对string进行md5加密转为大写 得到sign
step3:拼接组合访问参数进行http请求:
将所有参数名和参数值采用utf-8进行URL编码(参数顺序可随意,但必须要包括签名参数),然后通过GET或POST发起请求,如:
http://xxx.sdongpo.com/openApi/commodity/list?appid=xxx&provider_id=100&commodity_id=111&sign=12AA12SD123SD1ssa& timestamp=1511332935
#注意事项
所有的请求和响应数据编码皆为utf-8格式,URL里的所有参数名和参数值请做URL编码。如果请求的Content-Type是application/x-www-form-urlencoded,则HTTP Body体里的所有参数值也做URL编码;如果是multipart/form-data格式,每个表单字段的参数值无需编码,但每个表单字段的charset部分需要指定为utf-8。
参数名与参数值拼装起来的URL长度小于1024个字符时,可以用GET发起请求;参数类型含byte[]类型或拼装好的请求URL过长时,必须用POST发起请求。所有API都可以用POST发起请求。
上一页
API调用协议
下一页
获得全部站点
Built with