快递100云打印技术文档

一、自定义打印接口

如有打印发货单等其他类打印需求，可使用该接口。通过管理后台模板配置，配置自定义模板，实现自定义打印功能。

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

https://poll.kuaidi100.com/printapi/printtask.do

请求参数（header）

请求参数（body）

param数据结构：

1.3 返回结果

data数据结构

1.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功",
    "data": {
        "taskId": "****",  // 任务ID
        ******
  }
}

1.5信息代码含义

二、附件打印接口

为各应用产品提供的智能化打印解决方案。对接后可以让企业、个人实现PC/手机无线打印，远程打印，多人共享打印。打印内容包括但不限于文档、发票、发货单、快递单等，搭配云盒使用，支持激光、喷墨、针式、热敏打印机类型。让企业和个人打印更高效、更便捷。 通过接口上传打印内容，图片或PDF、Word等文件，即可打印该内容。

2.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

2.2 请求地址

https://poll.kuaidi100.com/printapi/printtask.do?method=imgOrder&key={key}&t={t}&param={param}&sign={sign}

请求参数（header）

请求参数（query）

body数据结构：

2.3 返回结果

data数据结构

2.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功",
    "data": {
        "taskId": "****",  // 任务ID 
        ******
    }
}

2.5信息代码含义

三、打印接口回调

通过上述接口提交的打印请求，进行打印状态返回。

3.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

3.2 请求地址

<form method="post" name="" action="[callbackUrl]">
    <input type="text" name="taskId" value="{XXX}" />
    <input type="text" name="param" value="{XXX}" />
    <input type="text" name="sign" value="签名字符串" />
</form>

请求参数：

param数据结构：

3.3 返回结果

3.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功"
}

说明：

其他信息快递100会忽略。

四、自定义生成图片接口

使用该接口可以自定义生成面单，发货单等的信息图片，并通过本地打印机打印。

4.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

4.2 请求地址

https://poll.kuaidi100.com/printapi/printtask.do

请求参数（header）

请求参数（body）：

param数据结构：

4.3 返回结果

data数据结构

4.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功",
    "data": {
        "taskId": "****",     // 任务ID
        "imgBase64": "****",  //面单BASE64编码图片 
         ******
   }
}

4.5 信息代码含义

五、 硬件状态接口

获取云打印机设备通讯状态。

5.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

5.2 请求地址

https://poll.kuaidi100.com/printapi/printtask.do

请求参数：

param数据结构：

5.3 返回结果

data数据结构

5.4 提供数据内容

{
    "result": true,
    "returnCode": "200",
    "message": "成功",
    "data": {
          "onLine": "****"  //设备状态
     }
} 

5.5 信息代码含义

六、指令打印接口

将原始打印指令进行zlib压缩，并转化为base64之后给到云打印机，实现云打印功能，适用于具有将打印内容转化成打印指令的商家以及从第三方接口（例：菜鸟、拼多多等）获取打印指令的商家（如第三方接口输出的指令已完成base64转化，则可直接通过云打印机打印）。

6.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

6.2 请求地址

https://poll.kuaidi100.com/printapi/printtask.do

请求参数（header）

请求参数（body）

param数据结构：

6.3 返回结果

data数据结构

6.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功",
    "data": {
        "taskId": "****",  // 任务ID
        ******
  }
}

6.5信息代码含义