打印地址贴

Owned by Seven Zhang
Last updated: 2019-04-23 by tuhao
1 min read

认证方法

在header中加入company_id和api_key,
或者再url中加入company_id和api_key.

两种获取面单方法比较


HTMLPDF
返回格式HTML文本PDF文件
依赖只有在浏览器中才能正确展示无
单个请求最多返回面单个数400左右  (建议单次100左右, 因为受 网络响应时间 和 浏览器内存限制. 请求的越多,需要的处理时间越长, 浏览器渲染时需要的内存也越多)200左右  (建议单次100左右, 因为受 网络响应时间 限制, 请求的越多, 需要的处理时间越长)
优点响应时间快,每个面单是独立的pdf展示,清晰度不会互相影响单个文件,便于存档以及在不同系统之间传递
缺点不能存档,每次都要去鸟系统获取. 信赖于浏览器.面单太多浏览器容易卡死多个面单合并成一个pdf, 处理字体比较小的面单时, 容易导致生成的面单打印效果模糊.

ps: chrome下测试,  html版可显示400多个.( apache 限制url长度是8192, 所以折算约450个id). 但是此时浏览器打印预览已经很卡了, 需要三四分钟才响应出来. 

      pdf版的话,可导出200个左右.数量再往上的话,稳定性差, 容易出现各种内存报错和网络超时报错.

一. HTML

GET  https://test.birdsystem.com/client/Printer/Packing-Slip/1903260360000045?type=AddressLabel&company_id=36&api_key=248ccb90dff2b99465b54c113765360c

将url中的订单id 1903260360000045 换为您的订单id

也可以一次获取多个地址贴, 将url中的订单id换为 您的多个订单id以下划线分割即可. 例如  1904210360032233_1904220360050834_1904210360032415

二. PDF

1. 单个获取PDF

GET https://test.birdsystem.com/client/Consignment/Get-Label/1903260360000045?company_id=36&api_key=248ccb90dff2b99465b54c113765360c

也可以一次获取多个地址贴, 将url中的订单id换为 您的多个订单id以下划线分割即可. 例如  1904210360032233_1904220360050834_1904210360032415

2. 批量获取PDF (TODO 目前还未实现)

https://www.birdsystem.com/client/Consignment/Batch-Get-Label

参数ids=1707100110059355,1707100110059356,1707100110059357,1707100110059358

返回为zip文件, 解压后, 是以订单id命名的pdf文件