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

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

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 increment = new ArrayList<>();
OrderIncrementDto orderIncrementDto = new OrderIncrementDto();
orderIncrementDto.setType(4);
orderIncrementDto.setAmount(new BigDecimal(888));
increment.add(orderIncrementDto);
ytoOrder.setIncrements(increment);
List 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 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> request = new HttpEntity(map, headers);
ResponseEntity response = restTemplate.postForEntity(PropertiesUtils.get("express.YTO.api"), request, Map.class, new Object[0]);
Map order = response.getBody();
return order;

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

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

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

JAVA对接圆通API

Java相关栏目本月热门文章