AI门票接口文档

本文档包含票务系统的核心接口：创建订单、核销订单、退单。所有接口均采用 DES-ECB 加密请求体，MD5 签名认证机制，请求 / 响应均为 JSON 格式。

1 通用规则

1.1 基础信息

1.2 请求结构

{
  "requestHead": {
    "method": "接口方法名",
    "timestamp": "秒级时间戳",
    "version": "接口版本",
    "userId": "用户ID",
    "sign": "签名串"
  },
  "requestBody": "DES加密后的请求体(Base64编码)"
}

1.3 签名规则

sign = MD5(userId + method + timestamp + version + encryptedBody + userKey)

• encryptedBody：DES 加密后的请求体 Base64 字符串
• userKey：用户密钥（用于 DES 加密和签名）

1.4 加密规则

用户密钥补齐 8 位（不足补空格，超过取前 8 位）
编码格式：UTF-8
请求和响应的报文body都是加密的，需要使用用户密钥加密和解密。

2 订单接口

2.1 创建订单接口

2.1.1 接口信息

2.1.2 请求报文

  {
      "createMan": "test_admin",
      "userNo": "user_001",
      "remark": "",
      "orderTitle": "测试门票订单",
      "totalMoney": 99.9,
      "orderCount": 2,
      "payType": 10,
      "payMoney": 95.0,
      "payOrderNo": "PAY20260317001",
      "payTime": "2026-03-17T10:00:00.000Z",
      "name": "张三",
      "mobileNo": "13800138000",
      "idNo": "110101199001011234",
      "purchaseOrderNo": "CG20260317001",
      "sellOrderNo": "",
      "barcodeNo": "",
      "userRemark": ""
    }

2.1.3 响应报文

{
  "orderNo": 100001,
  "purchaseOrderNo": "CG20260317001",
  "reserveCount": 2,
  "createTime": "2026-03-17T09:50:00.000Z"
}

2.2 核销订单接口

2.2.1 接口信息

2.2.2 请求报文

{
  "createMan": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
  "thirdCheckNo": "1000000001",
  "orderNo": 1,
  "remark": "",
  "checkCount": 1,
}

2.2.3 响应报文

{
  "checkNo": 200001,
  "orderNo": 1,
  "checkCount": 1,
  "thirdCheckNo": "1000000001"
}

2.3 退单接口

2.2.1 接口信息

2.3.2 请求报文

{
  "createMan": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
  "thirdRefundNo": "1000000001",
  "orderNo": 1,
  "remark": "",
  "refundCount": 2
}

2.3.3 响应报文

{
  "refundNo": 300001,
  "orderNo": 1,
  "refundCount": 2,
  "refundMoney": 95.0,
  "thirdRefundNo": "1000000001"
}

2.4 查询订单接口

2.4.1接口信息

2.4.2 请求报文

 {
  "orderNo": 1
}

2.4.3 响应报文

{
  "orderNo": 1,
  "orderTitle": "测试门票订单",
  "totalMoney": 99.9,
  "orderCount": 2,
  "checkCount": 1,
  "reserveCount": 1,
  "refundCount": 0,
  "payType": 10,
  "payMoney": 95.0,
  "payOrderNo": "PAY20260317001",
  "payTime": "2026-03-17T10:00:00.000Z",
  "mobileNo": "13800138000",
  "purchaseOrderNo": "CG20260317001",
  "sellOrderNo": "",
  "createTime": "2026-03-17T09:50:00.000Z",
  "status": "部分核销"
}

2.5 核销订单通知接口

2.5.1 接口信息

2.5.2 请求报文

  {
  "orderNo": 1,
  "currentCheckCount": 1,
  "totalCheckCount": 1
}

2.5.3 响应报文

{
  "resCode": "1000",
  "resMsg": "通知成功"
}

注意：以上报文直接明文返回，不需要加密。