通过调用查询指定设备治具接口（/api/Fixture/getFixtureData），向开放平台查询指定打印机下所有可用的治具及其关联商品数据，平台同步返回治具 ID、名称、宽高、状态、封面图及治具内各商品的排版参数（唯一标识、尺寸、行列数、间距、原点坐标等），用于前端治具选择、合并打印参数预加载与多治具排版计算。
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | https://www.colorpark.cn/api/Fixture/getFixtureData |
| 请求方式 | POST |
请求参数
| 参数名 | 参数值（示例） | 数据类型 | 必填项 | 参数说明 |
|---|---|---|---|---|
| printer_id | 500001 | string | 是 | 打印机分配的唯一 ID 号，每一台打印都会分配一个不同的编号 |
| once | 8305 | string | 是 | 加密生成签名时使用的随机数值 |
| time | 1646790335 | string | 是 | 加密生成签名时使用的时间戳 |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | 是 | 生成的签名，生成方式请参考《底层方法【基础支撑】》生成签名章节 |
| fixture_id | 15 | string | 否 | 治具 ID，获取特定的治具数据 |
返回结果示例
{
"code": 0,
"msg": "获取成功",
"data": [
{
"fixture_id": 180, //治具ID
"fixture_name": "常规高尔夫25mm", //治具名称
"fixture_width": "185.0", //治具宽度
"fixture_height": "140.0", //治具高度
"fixture_status": 1, //治具状态
"fixture_status_text": "启用", //治具状态名称
"fixture_image": "https://xxx.xxx.xxx/tupian.jpg", //治具封面图片
"fixture_goods": { //治具关联商品
"GOLF25": {
"unique": "GOLF25", //治具商品标识
"name": "常规高尔夫25mm", //治具商品名称
"width": "25.00", //治具商品宽度
"height": "25.00", //治具商品高度
"row_num": 1, // 每行打印的商品数
"column_num": 1, //每列打印的商品数
"spacing_left": "0.00", //左间距(mm)
"spacing_top": "0.00", //上间距(mm)
"origin_x": "0.00", //右下打印起始点X(mm)
"origin_y": "0.00" //右下打印起始点Y(mm)
}
}
},
{
"fixture_id": 179,
"fixture_name": "常规五合一",
"fixture_width": "185.0",
"fixture_height": "140.0",
"fixture_status": 1,
"fixture_status_text": "启用",
"fixture_image": "https://xxx.xxx.xxx/tupian.jpg",
"fixture_goods": {
"RefrigeratorMagnet": {
"unique": "RefrigeratorMagnet",
"name": "常规模板-冰箱贴",
"width": "57.10",
"height": "74.50",
"row_num": 1,
"column_num": 1,
"spacing_left": "0.00",
"spacing_top": "0.00",
"origin_x": "124.50",
"origin_y": "56.90"
},
"Coin": {
"unique": "Coin",
"name": "常规模板-纪念币",
"width": "50.10",
"height": "50.10",
"row_num": 1,
"column_num": 1,
"spacing_left": "0.00",
"spacing_top": "0.00",
"origin_x": "69.90",
"origin_y": "79.90"
},
"Circularbadge2": {
"unique": "Circularbadge2",
"name": "常规模板-圆形吧唧",
"width": "58.80",
"height": "58.80",
"row_num": 1,
"column_num": 1,
"spacing_left": "0.00",
"spacing_top": "0.00",
"origin_x": "65.90",
"origin_y": "4.90"
},
"Squarejigsawpuzzle": {
"unique": "Squarejigsawpuzzle",
"name": "常规模板-正方形拼图",
"width": "55.10",
"height": "55.60",
"row_num": 1,
"column_num": 1,
"spacing_left": "0.00",
"spacing_top": "0.00",
"origin_x": "5.00",
"origin_y": "10.00"
},
"Circularjigsawpuzzle": {
"unique": "Circularjigsawpuzzle",
"name": "常规模板-圆形拼图",
"width": "59.70",
"height": "59.70",
"row_num": 1,
"column_num": 1,
"spacing_left": "0.00",
"spacing_top": "0.00",
"origin_x": "6.20",
"origin_y": "75.20"
}
}
}
]
}若设备在调试过程中遇到不能解决问题，可以联系云打印负责人排除问题，找到解决的方法。联系方法如下： 电 话：137-5177-4454【微信同号】 邮 箱：info@ColorPark.cn