集成久通云运单详情

概述

为方便客户将久通云运单详情集成到自己的系统，对按如下方式获取到的运单详情做了头部隐藏处理。

接口请求地址：

• 测试环境地址：http://120.25.245.20:8092/OpenApi
• 生产环境地址(中国大陆)：https://cloud.assetscontrols.com:3443/OpenApi
• 生产环境地址(中国香港)：https://icloud.assetscontrols.com:3443/OpenApi
• 生产环境地址(开罗)：https://kcloud.assetscontrols.com:3443/OpenApi

请求方式：

• POST

请求头：

操作步骤

1.获取身份鉴权信息(Token)

同一用户获取到的token是固定值，建议将token缓存起来，不必反复请求。

请求路径: /login

请求参数:

返回示例:

正确时返回:

{
    "Result": 200,
    "Message":"success",
    "FObject": [{
        "FUserName": "admin",
        "FUserGUID": "63C399BD-2A0B-40E9-857D-6DEBF4908F92",
        "FTokenID": "DB7F20D9-84C3-44C3-B05A-06A9C392A189",
        "FExpireTime": "2020-07-30T08:00:00"
    }]
}

错误时返回:

{
    "Result": 103,
    "Message": "userName or password is error",
    "FObject": null
}

返回参数说明:

备注:

• 更多返回错误代码如下：
• 106：账户过期
• 103：用户名或者密码错误
• 102：请求参数错误

Postman 请求示例:

2.根据条件获取运单URL

请求接口将根据运单号和运单号匹配符合条件的运单。如果匹配成功，将返回运单详情链接，否则返回空信息。

请求路径: /KLRoute

请求参数:

返回示例:

正确时返回:

{
    "Result": 200,
    "Message": "check token success",
    "FObject": "https://xxx.assetscontrols.com:2443/fxydindex.html#/?480&xxx&10&isIframe"
}

查询不到结果时返回:

{
    "Result": 200,
    "Message": "check token success",
    "FObject": []
}

错误时返回:

{
    "Result": 102,
    "Message": "parameters(FTokenID/FAction) are error",
    "FObject": []
}

返回参数说明:

备注:

• 更多返回错误代码如下：
• 102：请求参数错误

Postman 请求示例:

3.将URL赋值给iframe标签

将获取到的URL赋值给待嵌入系统中iframe标签的src属性即可。