目录

随着目前趋势的发展有非常多的科技公司研发的系统项目大部分都会有需要对接第三方接口的需求，但是也面临着这样的一个问题，有一些没有对接过第三方接口的小伙伴不清楚该如何接入，相信有很多自研项目，特别是电商类的项目都会有需要对接物流各种快递Api接口，那么接下来分享一个我自己对接过第三方系统Api接口栗子。

术语

对于一般人，电子面单的意思可能并不是很了解；说白了，就是快递员给你打印的快递单的电子版。 **功能描述：**接口提供给用户自主打单的服务，提供异步和同步返回面单pdf文件方式。 异步方式： 面单pdf文件会直接推送到用户配置的回调地址 同步方式： 不需要配置回调地址，接口会同步返回面单pdf文件的url地址，下载时需要请求头携带对应token

面单对接流程图

需要对接第三方系统Api首先要先了解它整个Api的调用过程，下面是一个对接第三方Api接口顺丰丰桥电子面单流程图。

Java实战栗子

**注意：**顺丰丰桥云面单打印接口调用默认的是异步调用，异步调用需要登录自己的顺丰丰桥账号到控制台，测试记录查询查看返回的报文，如果需要同步调用则需要在请求参数上设置Sync等于true，本栗子是同步调用，是否要同步调用或异步调用根据实际需求设置即可。

请求示例应用场景(JSON)示例

自定义模板编码，当需要使用模板编辑器编辑自定义区时，将自定义模板编码赋值该字段 自定义模板必须是已发布的，且规格要和需要打印的模板对应

/**
	 * 云打印面单请求报文
	 * @param fhhzdH
	 * @param templateCode //模板编码
	 * @return
	 */
	private String getData (FhhzdH fhhzdH, String templateCode) {
          
   		
		SFNoodleParam param = new SFNoodleParam();
		param.setTemplateCode(templateCode);//模板编码
		param.setVersion("2.0");//版本号，传固定值:2.0
		param.setFileType("pdf");//文件类型
		param.setSync(true);//true 同步 false 异步(默认是异步，如果需要异步sync不需要作为参数传参)
		List<Documents> documents = new ArrayList<Documents>();
		Documents document = new Documents();
		document.setMasterWaybillNo(fhhzdH.getKddh());//顺丰下单时生成的快递单号	
		documents.add(document);
		param.setDocuments(documents);//业务数据		 
		String msgData = new Gson().toJson(param).toString();//转为json
		log.info("云打印面单实际请求----------------------------------"+msgData);
		return msgData;
	}

请求接口响应报文

Postman请求返回示例