业务接口

1、推送接单信息

POST
/edianyun/handlePushMessage/receivePendingOrder

{
    "serviceType": 5,
    "serviceTypeDesc": "安装单",
    "canTakeOrder": true,
    "remark": "",
    "serviceTimeliness": "2H上门",
    "source": 0,
    "ticketLoc": {
        "lat": 39.85854,
        "lon": 116.28673
    },
    "bugDescribe": "Cesar",
    "serviceContentList": [
        3
    ],
    "deviceList": [
        {
            "skuName": "惠普(HP) P232 20英寸显示器(IPS/1280*800/1年下一工作日上门)",
            "sn": "DUOXSQ1221122"
        }
    ],
    "serviceId": 121238,
    "preLatestTime": "2024-08-23 10:33:00",
    "ticketId": 66803
}

3、工单状态更新

POST
/edianyun/handlePushMessage/externalOrderStatus

参数

{
    "serviceId":11251,
    "source":0,
    "externalOrderStatus":1
}

4、质检结果同步

POST
/edianyun/handlePushMessage/qualityCheckResult

5、工程师信息

GET
/edianyun/engineerInfo

请求示例：

curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer 2d57a693-d026-44f0-aabc-1f093738b53a' 'http://uat.kf.ai:7310/edianyun/engineerInfo/engineerId/2290'

响应

{
  "code": 0,
  "subCode": null,
  "data": {
    "accountId": 2290,
    "name": "李缘圆",
    "idNumber": "111222199809251111",
    "examInfos": [
      {
        "paperNum": "KS2024090503",
        "title": "易点云技术考试题",
        "score": 60,
        "pass": 1,
        "updateTime": "2024-09-05 11:23:21"
      }
    ]
  },
  "msg": "成功"
}

score：分数
pass：1.及格 2.未及格（该接口返回都是及格的记录）

url signature 签名

/edianyun/jsApi/signature

示例：
curl -X GET –header ‘Accept: application/json’ –header ‘Authorization: Bearer 6c16279c-fe90-4fe2-97a2-a61e1a081619’ ‘http://uat.kf.ai:7310/edianyun/jsApi/signature?url=https%3A%2F%2Fkf.ai'

参数：url
响应：

  "code": 0,
  "subCode": null,
  "data": {
    "appId": "wxfcd7c832b8604066",
    "nonceStr": "mbBplnBML6qaOi0T",
    "timestamp": 1725876240,
    "url": "https://kf.ai",
    "signature": "258f847cbd0e79f2cfe211b94a037eb9e8d0333d"
  },
  "msg": "成功"
}

携带token请求业务接口

header ‘Authorization: Bearer 6beb924b-7991-402c-b07b-981184fbcb94’

比如：

connection.setRequestProperty("Authorization", "Bearer " + token);

code 字段描述

subCode 字段

当code=1时，产生响应的subCode

msg 字段

正常会响应：成功
出错是响应对应的错误描述