API 文档 - 包装盒魔法师

概览

基础信息

基础 URL	`http://11028.com/e/api.php`
请求格式	JSON / Form Data
响应格式	JSON
字符编码	UTF-8

支持的盒型

ID: 0

飞机盒

ID: 1

双插盒

ID: 2

扣底盒

ID: 3

手提盒

ID: 4

粘底盒

ID: 5

纸箱

通用响应格式

{
  "success": true,
  "data": { ... }
}

错误时返回：

{
  "success": false,
  "error": "错误信息"
}

盒型列表

GET ?action=list_types 获取所有支持的盒型列表

请求示例

GET /api.php?action=list_types

响应示例

{
  "success": true,
  "types": [
    { "id": 0, "name": "飞机盒", "file": "feijihe.php" },
    { "id": 1, "name": "双插盒", "file": "shuangchahe.php" },
    ...
  ]
}

生成刀线

POST ?action=generate 生成指定盒型的刀线数据

请求参数

参数名	类型	说明
action必填	string	固定值 "generate"
box_type必填	int	盒型 ID（0-5）
params可选	object	自定义参数（JSON 对象）

请求示例

POST /api.php
Content-Type: application/json

{
  "action": "generate",
  "box_type": 0,
  "params": {
    "length": 200,
    "width": 150,
    "height": 80
  }
}

响应示例

{
  "success": true,
  "data": {
    "box_type": 0,
    "params": { ... },
    "paths": [ ... ],
    "bbox": { "x": 0, "y": 0, "w": 450, "h": 320 }
  }
}

导出 SVG

GET ?action=export_svg 导出 SVG 格式刀线图

请求参数

参数名	类型	说明
action必填	string	固定值 "export_svg"
box_type必填	int	盒型 ID（0-5）
labeled可选	int	是否标注尺寸（0 或 1）
params可选	object	自定义参数

请求示例

GET /api.php?action=export_svg&box_type=0&labeled=1

响应

直接下载 SVG 文件，Content-Type: image/svg+xml

导出 PDF

GET ?action=export_pdf 导出矢量 PDF（Adobe Illustrator 可编辑）

请求参数

参数名	类型	说明
action必填	string	固定值 "export_pdf"
box_type必填	int	盒型 ID（0-5）
params可选	object	自定义参数

请求示例

GET /api.php?action=export_pdf&box_type=1

响应

直接下载 PDF 文件，Content-Type: application/pdf

导出 DXF

GET ?action=export_dxf 导出矢量 DXF（AutoCAD 可编辑）

请求参数

参数名	类型	说明
action必填	string	固定值 "export_dxf"
box_type必填	int	盒型 ID（0-5）
params可选	object	自定义参数

请求示例

GET /api.php?action=export_dxf&box_type=2

响应

直接下载 DXF 文件，Content-Type: application/dxf

导出 JSON

GET ?action=export_json 导出 JSON 格式刀线数据

请求参数

参数名	类型	说明
action必填	string	固定值 "export_json"
box_type必填	int	盒型 ID（0-5）
params可选	object	自定义参数

请求示例

GET /api.php?action=export_json&box_type=0

响应

直接下载 JSON 文件，Content-Type: application/json

获取配置

GET ?action=get_config 获取当前默认配置参数

请求示例

GET /api.php?action=get_config

响应示例

{
  "success": true,
  "config": {
    "length": 200,
    "width": 150,
    "height": 80,
    ...
  }
}

保存配置

POST ?action=save_config 保存默认配置参数

请求参数

参数名	类型	说明
action必填	string	固定值 "save_config"
config必填	object	配置参数（JSON 对象）

请求示例

POST /api.php
Content-Type: application/json

{
  "action": "save_config",
  "config": {
    "length": 250,
    "width": 180,
    "height": 100
  }
}

响应示例

{
  "success": true,
  "message": "配置保存成功"
}