JAVA对接圆通API

登录圆通开放平台,根据开发者指南中新手操作指引完成认证,申请测试接口

 申请调试成功后,页面如下:

 注:接口管理上面注意事项也要知晓哦!!!

准备工作都做完了,接下来进入正题,撸代码

• 首先我们先将接口的一些信息写进配置文件,方便后续修改(若写死在代码中,后续还要更改代码)

#圆通
#隐私面单下单接口
express.YTO.api=https://openuat.yto56.com.cn:6443/open/privacy_create_adapter/v1/xL4I4D/客户编码
#客户编码
express.YTO.clientId=
#秘钥
express.YTO.secret=
#方法
express.YTO.method=privacy_create_adapter
#版本
express.YTO.edition=v1

•  建立工具类,将官网给出的签名工具复制粘贴进来

/**
  * 圆通签名获取
  * 开放平台公共加密方法-使用commons-codec-1.11.jar进行md5加密,然后对数组进行base64编码
  * @param data   = param+method+v
  * @param secret
  * @return
  */
public static String encryptSignForOpen(String data, String secret) {
    String sign;
      try {
          byte[] signByte = DigestUtils.md5(data + secret);
          sign = Base64.encodeBase64String(signByte);
       } catch (Throwable e) {
          log.error("加密失败.e:{}.", e.toString());
          sign = "ERROR";
      }
   return sign;
}

注:一定要注意base64jar包引入问题。

要使用

import com.sun.org.apache.xml.internal.security.utils.Base64;

如果使用了

import org.apache.commons.codec.binary.Base64;

就好报错：Input length must be multiple of 16 when decrypting with padded cipher

•  接下来进入代码正题
• 第一步根据官方给的文档设置接口参数(对接面单下单接口)

• 第二步获取签名,将请求参数转换json字符串与方法名、版本进行拼接,然后和秘钥一起传入官方提供的方法
• 下面是全部代码

//参数设置
YTOOrder ytoOrder = new YTOOrder();
ytoOrder.setSenderName("张三");
ytoOrder.setSenderProvinceName("江苏省");
ytoOrder.setSenderCityName("苏州市");
ytoOrder.setSenderCountyName("工业园区");
ytoOrder.setSenderAddress("金鸡湖大道88号");
ytoOrder.setSenderMobile("15900521555");

ytoOrder.setRecipientName("李四");
ytoOrder.setRecipientProvinceName("江苏省");
ytoOrder.setRecipientCityName("徐州市");
ytoOrder.setRecipientCountyName("泉山区");
ytoOrder.setRecipientAddress("湖中路");
ytoOrder.setRecipientMobile("021-5985121");
ytoOrder.setRemark("测试");

List<OrderIncrementDto> increment = new ArrayList<>();
OrderIncrementDto orderIncrementDto = new OrderIncrementDto();
orderIncrementDto.setType(4);
orderIncrementDto.setAmount(new BigDecimal(888));
increment.add(orderIncrementDto);
ytoOrder.setIncrements(increment);
List<OrderGoodsDto> goods = new ArrayList<>();
OrderGoodsDto goodsDto = new OrderGoodsDto();
goodsDto.setName("mobile");
goodsDto.setWeight(new BigDecimal(5));
goodsDto.setLength(new BigDecimal(10));
goodsDto.setWidth(new BigDecimal(20));
goodsDto.setHeight(new BigDecimal(5));
goodsDto.setPrice(new BigDecimal(100));
goodsDto.setQuantity(1);
goods.add(goodsDto);
ytoOrder.setGoods(goods);
//生成7位随机物流单号
ytoOrder.setLogisticsNo(S.newRandomNum(7));
String jsonString = JSON.toJSONString(ytoOrder);
String data = jsonString + PropertiesUtils.get("express.YTO.method") + PropertiesUtils.get("express.YTO.edition");
//签名
String sign = AutographUnits.encryptSignForOpen(data, PropertiesUtils.get("express.YTO.secret"));
//封装参数
Map<String, String> map = new HashMap<>();
//获取时间戳
map.put("timestamp", String.valueOf(System.currentTimeMillis()));
map.put("param", jsonString);
map.put("sign", sign);
map.put("format", "JSON");
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.parseMediaType("application/json; charset=UTF-8"));
HttpEntity<MultiValueMap<String, String>> request = new HttpEntity(map, headers);
ResponseEntity<Map> response = restTemplate.postForEntity(PropertiesUtils.get("express.YTO.api"), request, Map.class, new Object[0]);
Map order = response.getBody();
return order;

•  请求结果会将三段码返回出来及快递单号

 注:拿到返回结果后就需要自己设计面单了，根据官网面单模板去设计与三段码、单号进行绑定。最后一定要记得要和网点人确认哦!!!(接口管理里会看到注意事项)

 最后大家要是觉得有用的话给博主一个赞哦!!!