导检系统 - 自助机取号 + 打印取号 接口调用完整文档

文档说明

本文档整合获取Token、自助机取号登记、打印取号模板三个接口，实现「鉴权→取号→打印」全流程调用，明确地址、参数、依赖关系与返回数据。

一、基础信息

• 接口版本：3.9.5
• 制定人：朱小乾
• 制定日期：2023-11-20
• 文档更新：2026-03-26
• 流程：获取Token → 自助机取号 → 打印取号（取号返回数据直接传入打印）

二、服务地址区分

1. 导检服务（Token/自助机取号）
   • 格式：http://{导检IP}:{端口}
   • 示例：http://192.168.1.100:5000
2. 打印服务（打印取号模板）
   • 格式：http://{客户端IP}:{端口}
   • 示例：http://127.0.0.1:8080

三、接口1：获取访问Token

基本信息

• 接口版本：3.2.3
• 请求URL：/api/External/Login
• 请求方式：POST
• 请求头：Content-Type: application/json

请求参数

正确返回

{
    "code": 0,
    "message": "操作成功",
    "data": {
        "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "expiresIn": 120
    }
}

错误返回

{
    "code": 1,
    "message": "获取Token失败",
    "busCode": "030101"
}

调用说明

• 成功后在所有需鉴权接口请求头添加：
  Authorization: Bearer {accessToken}
• expiresIn单位：分钟

四、接口2：自助机取号登记

基本信息

• 接口版本：3.9.5
• 请求URL：/api/External/GetNumberRegistraction
• 请求方式：POST
• 服务地址：导检服务IP+端口

请求头

请求参数

正确返回（打印接口直接使用此字段）

{
    "code": 0,
    "message": "操作成功",
    "data": {
        "examNo": 10021,
        "independentNo": 9,
        "independentNoPrefix": "",
        "orders": "9",
        "queueName": "取号测试",
        "aveTime": 200,
        "waitTime": 1800,
        "examPositionNames": []
    }
}

错误返回

{
    "code": 1,
    "message": "",
    "data": null
}

五、接口3：打印取号模板

基本信息

• 接口版本：3.9.5
• 请求URL：/socketApi/Print/PrintGetNumber
• 请求方式：POST
• 服务地址：客户端IP+端口

请求头

请求参数（Data直接复用自助机取号返回）

测试入参示例

{
    "BusCode": 1,
    "TemplateName": "",
    "Data": {
        "examNo": 10021,
        "independentNo": 9,
        "independentNoPrefix": "",
        "orders": "9",
        "queueName": "取号测试",
        "aveTime": 200,
        "waitTime": 1800,
        "examPositionNames": []
    }
}

六、完整调用流程（标准步骤）

1. 调用获取Token接口，拿到accessToken。
2. 携带Token调用自助机取号，拿到取号结果Data。
3. 将取号Data填入打印取号模板接口，完成打印。

七、字段映射关系

自助机取号返回 → 打印接口Data字段完全一致，可直接透传：

• examNo
• independentNo
• independentNoPrefix
• orders
• queueName
• aveTime
• waitTime
• examPositionNames

八、异常处理

1. Token过期：重新调用登录接口获取。
2. 取号失败：检查departId、网络与权限。
3. 打印失败：检查客户端IP/端口、printTemplateType=1、Data格式。

要不要我帮你把这份文档导出成标准PDF/Word版，直接可交付使用？