接口规范

第三方接入

接口规范

接口描述

接口遵循REST规范，使用HTTP GET或POST方式进行通讯。

获取标签列表

点击获取列表

点击获取标签列表

点击获取标签列表

获取标签列表示例代码

JS

 1$.ajax({
 2    url:"http://demo.24on.cn:29000/GetLabelList.ashx",
 3    type:"GET",
 4    dataType:"JSON",
 5    timeout:10000,
 6    async:false,
 7    success:function(res){
 8        console.log(res); 
 9    },
10    error:function(){
11        console.error("获取失败！");
12    }
13});

获取标签列表API说明

接口地址 http://[ydb_webservice_url]: [ydb_webservice_port]/GetLabelList.ashx
请求方式 HTTP GET
参数说明

ydb_webservice_url：易打标标签服务IP地址

ydb_webservice_port：易打标标签服务端口号（默认29000）
响应格式 application/json
响应示例 
{
        "data" : [
            {
                "FID" : "00000000-0000-0000-0001-000000000001",
                "FName" : "通用",
                "FParentID" : "0",
                "Labels" : [
                    {
                    "FClass" : "00000000-0000-0000-0001-000000000001",
                    "FCode" : "492B9612-FF21-4314-B967-B3C34D53E2AD",
                    "FDataSource" : "[ \"二维码\", \"RFID\" ]\n",
                    "FID" : "4D17C783-FDB8-4f5a-ABCF-CBBF70165808",
                    "FIsRegex" : 0,
                    "FName" : "新建标签",
                    "FNote" : "",
                    "FPriority" : 0
                    }
                ]
            }
        ],
        "msg" : "成功！",
        "ret" : 0
        }

获取打印服务列表

点击获取列表

点击获取打印服务列表

点击获取打印服务列表

获取打印服务列表示例代码

JS

 1$.ajax({
 2    url:"http://[ydb_webservice_url]: [ydb_webservice_port]/GetPrintServiceList.ashx",
 3    type:"GET",
 4    dataType:"JSON",
 5    timeout:10000,
 6    async:false,
 7    success:function(res){
 8        console.log(res); 
 9    },
10    error:function(){
11        console.error("获取失败！");
12    }
13});

获取打印服务列表API

接口地址 http://[ydb_webservice_url]: [ydb_webservice_port]/GetPrintServiceList.ashx
请求方式 HTTP GET
参数说明

ydb_webservice_url：易打标标签服务IP地址

ydb_webservice_port：易打标标签服务端口号（默认29000）
响应格式 application/json
响应示例 
{
        "data" : [
        {
            "id" : "D2E2ED484988DFB0512DF5964A63F1BC",
            "ipaddr" : "192.168.10.250",
            "name" : "易打标打印服务",
            "port" : 29000,
            "printers" : [
                {
                    "desc" : "--",
                    "name" : "LPT3"
                },
                {
                    "desc" : "",
                    "name" : "pdfFactory Pro"
                }
            ]
        }
        ],
        "msg" : "成功！",
        "ret" : 0
        }
版本要求 易打标企业版V3.7或更高版本

打印预览

注：（选择打印服务与选择标签皆与上例 「 打印服务列表 」 | 「 标签列表 」 相同可参考上面例子做出选择）

点击预览默认打印

JSON

打印预览示例代码

HTML

 
    <form class="uploadDataForm" enctype="multipart/form-data" target='_blank' method="POST"action="http://demo.24on.cn:29000/Preview.ashx?id=B633E77A-9C8B-4224-850B-74FC51C57937&service=">
    
    <input type="text" name="data1" >
        <input type="text" name="data2" >
        <input type="text" name="data3" >
        <input type="text" name="data4" >
        <input type="text" name="data5" >
   <input type="submit" value="提交">
    </form>

打印预览API

接口地址 http://[ydb_webservice_url]: [ydb_webservice_port]/Preview.ashx?id=[id]&code=[code]&service=[service]
请求方式

GET或POST

注:

以GET方式访问时将以标签默认值作为打印数据，一般只做测试。

POST方式需将打印数据以application/json 格式作为BODY传递到服务器。
参数说明

ydb_webservice_url：易打标标签服务IP地址

ydb_webservice_port：易打标标签服务端口号（默认29000）

id：标签ID

code：标签编号

service：标签服务ID

id和code只需设置一项，id优先级高于code
BODY示例

[

{ "条码": "98798", "名称": "苹果", "重量": "0.5kg"},

{ "条码": "654636", "名称": "苹果", "重量": "1.2kg"}

]
响应格式 text/html
响应示例 示例图片
备注

1、此接口返回的是一个完整的HTML页面，请在浏览器中打开或者以WebView等控件加载。

2、打印服务IP和端口可以标签服务的“获取打印服务列表”获取。
版本要求 易打标企业版V3.7或更高版本

静默打印

注：（选择打印服务与选择标签皆与上例 「 打印服务列表 」 | 「 标签列表 」 相同可参考上面例子做出选择）

点击打印

调用静默打印示例代码

JSON

JS

 1$.ajax({
 2    url:"http://demo.24on.cn:29000/Print.ashx?id=4D17C783-FDB8-4f5a-ABCF-CBBF70165808&service=1B7581675CA7B787A1E3F217B1BF73F8&printer=pdfFactory%20Pro",
 3    type:"POST",
 4    data:{data:'[{ "条码": "98798", "名称": "苹果", "重量": "0.5kg"}]'},
 5    dataType:"JSON",
 6    timeout:10000,
 7    async:false,
 8    success:function(res){
 9        if(res.ret== 0);
10        {
11            console.log("打印成功！");
12        }
13    },
14    error:function(){
15        console.error("获取失败！");
16    }
17});

调用打印API

接口地址 http://[ydb_webservice_url]: [ydb_webservice_port]/Print.ashx?id=[id]&service=[service]&printer=[printer]&copies=[copies]&default=[default]&unique=[ unique]
请求方式 HTTP POST

需将打印数据以application/json 格式作为BODY传递到服务器。
参数说明 
ydb_webservice_url：易打标标签服务IP地址
    ydb_webservice_port：易打标标签服务端口号（默认29000）
    id：标签ID（规则与Preview接口相同）
    service：打印服务ID
    printer：打印机（如果此标签绑定了默认打印机，可不传）
    copies：打印份数（可不传，默认为1）
    default：为空时是否打印默认值（可不传，默认为0）
    unique：关键词判重（仅对设置了关键词的标签生效，可不传，默认为0
响应格式 application/json
BODY示例

[

{ "条码": "98798", "名称": "苹果", "重量": "0.5kg"},

{ "条码": "654636", "名称": "苹果", "重量": "1.2kg"}

]
响应示例 
{
    "data" : [
        {
            "index": 0,
            "ret" : 0,
            "msg" : "打印成功"
        },
        {
            "index": 1,
            "ret" : -16
            "msg" : "关键词不能为空"
        }
    ],
    "msg" : "共2条记录，成功 1 失败1",
    "ret" : 0
    }
版本要求 易打标企业版V3.7或更高版本

判断标签是否可编辑

检查

判断标签是否可编辑API

接口地址 http://[ydb_webservice_url]: [ydb_webservice_port]/ IsDataSourceEditable.ashx?id=[id]&code=[code]
请求方式 HTTP GET
参数说明 
ydb_webservice_url：易打标标签服务IP地址
        ydb_webservice_port：易打标标签服务端口号（默认29000）
        id：标签ID（规则与Preview接口相同）
        code：标签编号
        id和code只需设置一项，id优先级高于code
响应格式 application/json
响应示例 
{
        "data" : 1,
        "msg" : "成功！",
        "ret" : 0
    }
版本要求 易打标企业版V3.7或更高版本

可编辑打印

注：（选择打印服务与选择标签皆与上例 「 打印服务列表 」 | 「 标签列表 」 相同可参考上面例子做出选择）

点击打印

调用可编辑打印示例代码

JSON

JS

 1<script type="text/javascript" src="http://demo.24on.cn:29000/ydb.js"></script>
 2<script>
 3    YDB.init();
 4    var postData= [
 5                {
 6                    "代码": "F0001",
 7                    "名称": "苹果",
 8                    "规格": "100kg"
 9                },
10                {
11                    "代码": "F0002",
12                    "名称": "菠萝",
13                    "规格": "200kg"
14                }
15            ];
16    //labelID-标签ID; serviceID-服务ID; postData-打印数据; printer-打印机名称; 
17    YDB.print(labelID, serviceID, postData, printer);
18</script>

可编辑打印API

获取JS地址 http://[ydb_webservice_url]:[ydb_webservice_port]/ydb.js
请求方式 
web获取示例：<script type="text/javascript" src="http://demo.24on.cn:29000/ydb.js"></script >
参数说明 
ydb_webservice_url：易打标标签服务IP地址
    ydb_webservice_port：易打标标签服务端口号（默认29000）
响应格式 application/x-javascript
函数说明 
    1:  YDB.init(); 
    初始化，只需调用一次，建议在页面加载后调用;
    2:  YDB.print(id, service, data, printer, copies, printDefault, uniqueKey)
    执行打印或预览（根据标签是否存在预览可编辑项，采用静默打印或预览打印），参数说明：
    Id   标签ID（必传）
    Service 打印服务ID（必传）
    Data 打印数据（JSON格式，必传）
    Printer 打印机（标签绑定了默认打印机时可为空）
    Copies 打印份数（可不传，默认1）
    PrintDefault 数据源为空时是否打印默认值（可不传，默认0）
    UniqueKey 是否关键词判重（可不传，默认0）
响应示例
版本要求 易打标企业版V3.7或更高版本

第三方接入

易打标平台，采用标准的API接口模式，可非常便捷的植入APP、微公号、钉钉等第三方平台，让您的应用，瞬间具有强大的标签设计、版本集中管理、全网任意打印的全套条码标签能力。

APP应用

24on平台，编写了一套安卓APP 演示程序，分别用源生代码、H5调用的形式，展示如何与易打标对接，并已将源代码上传码云您可不受任何限制的使用源码，加以改造，应用到项目中。

扫描正上方二维码下载易打标Demo App

密码：24on

扫描正上方二维码下载易打标Demo App源码

APP演示Demo，部分页面示例如下：

微公号接入

集成了易打标的应用，可轻松接入微信公众号，示例：

钉钉接入

集成了易打标的应用，可轻松接入钉钉平台，示例：

厂商合作

易打标通过平台定制模式，可与条码设备厂商、互联网平台网，开展广泛合作：

1、为打印机、智能PDA等硬件厂商，开放云标签SaaS平台，购买设备后，用户即可开通云标签账号，即时具有标签各项功能；

2、为Iot等设备厂商，开发易打标SDK或SO库，嵌入打印盒子等网关设备，实现标签移动/全网场景的打印；

3、通过易打标的私有云部署，为互联网平台商，集成易打标的各项标签功能；