2.3 获取地址贴
批量订单创建成功后，等待大约1-3分钟, 下一步是获取面单。
获取面单有两种格式: PDF格式 和 HTML格式
PDF格式是二进制流，可以保存成PDF文件，在不同系统中交换.
HTML格式是可以直接在浏览器中打开的页面，利用浏览器的打印网页功能直接打印.
PDF格式 接口说明
URL | |||
接口功能 | 获取PDF格式的面单 | ||
支持参数格式 | URL | 开发人员 |
|
请求方式 | GET | 发布日期 |
|
PDF格式 请求参数：
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | STRING | 必填 | 订单ID, 多个订单ID用下划线分隔, 例如 1904210360032233_1904220360050834_1904210360032415 |
PDF格式 认证方法
在header中加入company_id和api_key, 或者在url中加入company_id和api_key.
PDF格式 返回格式
PDF文件的字节流
PDF格式 注意事项
一次最多返回200张面单 (建议单次100左右, 因为受网络响应时间限制, 请求的越多, 需要的处理时间越长)
多个面单合并成一个pdf, 处理字体比较小的面单时, 容易导致生成的面单打印效果模糊.
HTML格式 接口说明
URL | |||
接口功能 | 在浏览器中打开HTML格式面单的页面 | ||
支持参数格式 | URL | 开发人员 |
|
请求方式 | GET | 发布日期 |
|
HTML格式 请求参数：
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | STRING | 必填 | 订单ID, 多个订单ID用下划线分隔, 例如 1904210360032233_1904220360050834_1904210360032415 |
HTML格式 认证方法
在header中加入company_id和api_key, 或者在url中加入company_id和api_key.
HTML格式 返回格式
可在浏览器中打开的HTML页面
HTML格式 注意事项
一次最多返回400张面单 (建议单次100左右, 因为受网络响应时间限制, 请求的越多, 需要的处理时间越长, 浏览器渲染时需要的内存也越多)
响应时间快,每个面单是独立的pdf展示,清晰度不会互相影响
不能存档,每次都要去鸟系统获取. 信赖于浏览器.面单太多浏览器容易卡死