进入魔镜注册页面
注册魔镜账号
进入魔镜管理平台
在API KEY页面生成密钥
生成签名
根据提单号查多条container轨迹
URL
POST https://gateway.uniner.com/open-api/api/shippingTrack/v1/queryShipments
描述
根据提单号查多条container轨迹
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| bookingNumber | string | 否 | 订舱号 |
| containerNumber | string | 否 | 柜号 |
| firmName | string | 是 | 公司简称 |
| ladingNumber | string | 否 | 提单号 |
| queryHarbor | int32 | 否 | 查询码头 ，默认否 |
| requestDT | int64 | 是 | 请求时间戳 |
| refresh | int32 | 否 | 刷新，不从本地数据库读取 |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| status | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| blno | string | 提单号 |
| bkgno | string | 订舱号 |
| pol | string | 装货港 |
| pod | string | 卸货港 |
| vel | string | 最新航程船名 |
| voy | string | 最新航程航次 |
| trackNodeVos | array | 轨迹节点列表 |
| conno | string | 箱号 |
| aging | string | 时效 |
| trackNodeVos | array | 轨迹节点列表 |
| statedescription | string | 状态描述 |
| status | string | 状态 |
| clientStatusName | string | 原状态名称 |
| clientStatusCode | string | 原状态编码 |
| eventtime | string | 轨迹时间 |
| sourcetime | string | 原始时间-pil 等根据*号判断作用 |
| station | string | 轨迹位置 |
| stationcd | string | 轨迹对应国家 |
| sourceInfo | string | 源信息 |
| vslName | string | 船名 |
| vslCode | string | 船缩写 |
| voy | string | 船次 |
| expectTime | string | 预计时间 |
| utcStation | string | utc位置 |
| utcOffset | string | utc偏移量 |
| utcDt | string | 统一时间 |
| actCd | string | 轨迹状态 A 实际发生，E 预计发生 |
| routeVos | array | 路由节点列表 |
| location | string | 位置 |
| minDT | string | 最小时间，用来排序 |
| trackNodeVos | array | 轨迹节点列表 |
| statedescription | string | 状态描述 |
| status | string | 状态 |
| clientStatusName | string | 原状态名称 |
| clientStatusCode | string | 原状态编码 |
| eventtime | string | 轨迹时间 |
| sourcetime | string | 原始时间-pil 等根据*号判断作用 复 |
| station | string | 轨迹位置 |
| stationcd | string | 轨迹对应国家 |
| sourceInfo | string | 源信息 |
| vslName | string | 船名 |
| vslCode | string | 船缩写 |
| voy | string | 船次 |
| expectTime | string | 预计时间 |
| utcStation | string | utc位置 |
| utcOffset | string | utc偏移量 |
| utcDt | string | 统一时间 |
| actCd | string | 轨迹状态 A 实际发生，E 预计发生 |
| source | string | No comments found. |
| lastStatus | string | 当前状态 |
| lastTrack | string | 当前轨迹 |
| shippingCarriages | array | 航程列表 |
| vslname | string | 船名 |
| vslcd | string | 船名编码 |
| voy | string | 航次 |
| pol | string | 出发港 |
| pod | string | 到达港 |
| polcd | string | 出发港简称 |
| podcd | string | 到达港简称 |
| etd | string | 预计离港时间 |
| eta | string | 预计到港时间 |
| atd | string | 实际离港时间 |
| ata | string | 实际到港时间 |
| source | string | No comments found. |
| queryStatus | int32 | 1 查询中 2 成功 |
| firmName | string | 船司 |
| queryNum | string | No comments found. |
| polCd | string | No comments found. |
| podCd | string | No comments found. |
| eta | string | No comments found. |
| receivePlace | string | 接货地 |
| deliveryPlace | string | 提货地 |
| deliveryPlaceET | string | 提货地预计到达时间 |
常用状态映射
| 名称 | 描述 |
|---|
| BKCF | 订舱 |
| STSP | 提空箱 |
| GITM | 进场 |
| LOBD | 装船 |
| DLPT | 离港 |
| BDAR | 抵港 |
| DSCH | 卸船 |
| STCS | 提柜(货) |
| RCVE | 还空 |
| TSDP | 中转开航 |
| TSBA | 中转抵港 |
| TSLB | 中转装船 |
| TSDC | 中转卸船 |
根据船名查询当前位置
URL
POST https://gateway.uniner.com/open-api/api/shippingTrack/shipPositionByName
描述
根据船名查询当前位置
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| requestDT | int64 | 是 | 请求时间戳 |
| velName | string | 是 | 船名 |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| status | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| map | map | No comments found. |
| any object | object | any object. |
根据船名和时间查询历史轨迹
URL
POST https://gateway.uniner.com/open-api/api/shippingTrack/shipPositionHistoryByNameDt
描述
根据船名和时间查询历史轨迹
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| requestDT | int64 | 是 | 请求时间戳 |
| velName | string | 是 | 船名 |
| sign | string | 是 | 签名 |
| startDt | string | 是 | 起始时间 |
| endDt | string | 是 | 结束时间 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| status | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| list | array | No comments found. |
| any object | object | any object. |
单条轨迹查询
URL
POST https://gateway.uniner.com/open-api/api/airLiftTrack/v1/queryBatch
描述
单条轨迹查询
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| firmName | string | 否 | 公司简称 |
| requestDT | int64 | 是 | 请求时间戳 |
| trackNumber | string | 是 | 空运单号 |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| status | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| waybillNo | string | 运单号 |
| trackNodeVos | array | 轨迹节点列表 |
| trackTime | string | 轨迹时间 |
| nodeName | string | 标准节点名称 |
| nodeCode | string | 标准节点编码 |
| clientName | string | 客户节点名称 |
| clientCode | string | 客户节点编码 |
| location | string | 当前轨迹位置 |
| num | string | 件数 |
| weight | string | 重量 |
| volume | string | 体积 |
| sourceInfo | string | 原节点信息 |
| expectTime | string | 轨迹预计时间 |
| utcOffset | string | No comments found. |
| utcDt | string | 统一时间 |
| airlift | string | 航司及代码 |
| route | string | 路由 |
| lastStatus | string | 最新状态 |
| lastTrack | string | 最新轨迹 |
| aging | string | 时效 |
| routeInfoVos | array | 路由对应节点 |
| routeCode | string | 路由编码 |
| nodeVos | array | 轨迹明细 |
| trackTime | string | 轨迹时间 |
| nodeName | string | 标准节点名称 |
| nodeCode | string | 标准节点编码 |
| clientName | string | 客户节点名称 |
| clientCode | string | 客户节点编码 |
| location | string | 当前轨迹位置 |
| num | string | 件数 |
| weight | string | 重量 |
| volume | string | 体积 |
| sourceInfo | string | 原节点信息 |
| expectTime | string | 轨迹预计时间 |
| utcOffset | string | No comments found. |
| utcDt | string | 统一时间 |
| flightInfoVos | array | 航班信息 |
| FlightStatus | string | 航班状态 |
| FlightNo | string | 航班号 |
| departStation | string | 离开地 |
| arriveStation | string | 到达地 |
| expectDepartTime | string | 预计起飞时间 |
| expectArriveTime | string | 预计到达时间 |
| actualDepartTime | string | 实际起飞时间 |
| actualArriveTime | string | 实际到达时间 |
| num | string | 件数 |
| weight | string | 重量 |
| volume | string | 体积 |
| sourceInfo | string | No comments found. |
| source | string | No comments found. |
| queryStatus | int32 | 1 查询中 2 成功 |
| num | string | 件数 |
| weight | string | 重量 |
| volume | string | 体积 |
常用状态映射
| 名称 | 描述 |
|---|
| BKD | 订舱 |
| RCS | 进仓 |
| MAN | 配载 |
| MNF | 报关 |
| DEP | 起飞 |
| ARR | 抵达 |
| RCF | 卸货 |
| CUS | 清关 |
| NFD | 到货通知 |
| DLV | 提货 |
单条轨迹查询
URL
POST https://gateway.uniner.com/open-api/api/expressTrack/v1/queryBatch
描述
单条轨迹查询
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| firmName | string | 是 | 公司简称 |
| postalCode | string | 否 | 邮政编码 GEL 需要传 |
| requestDT | int64 | 是 | 请求时间戳 |
| waybillNo | string | 否 | 单号(多个用,号分割) |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| status | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| waybillNo | string | 运单号 |
| trackNodeVos | array | 轨迹节点列表 |
| trackTime | string | 轨迹时间 |
| nodeName | string | 标准节点名称 |
| nodeCode | string | 标准节点编码 |
| clientName | string | 客户节点名称 |
| clientCode | string | 客户节点编码 |
| location | string | 当前轨迹位置 |
| sourceInfo | string | 原节点信息 |
| utcStation | string | utc位置 |
| utcOffset | string | utc偏移量 |
| utcDt | string | 统一时间 |
| provider | string | 服务商 |
| lastStatus | string | 当前状态 |
| lastTrack | string | 当前轨迹 |
| lastStatusCd | string | 当前状态编码 |
| aging | string | 时效 |
| lastNormalStatus | int32 | 1 接收信息 2 上网 3运输中 4 派送中 5 签收 6 异常 |
| queryStatus | int32 | 1 查询中 2 成功 |
| originAddr | string | 始发 |
| destAddr | string | 目的 |
常用状态映射
| 名称 | 描述 |
|---|
| PU | 取件扫描 |
| EP | 出口扫描 |
| DP | 离开设施 |
| AR | 抵达设施 |
| VK | 完成清关 |
| OR | 起运地扫描 |
| SX | 运输途中 |
| IP | 进口扫描 |
| OF | 外出递送 |
| 9E | 已递送 |
| YP | 设施处理 |
| RS | 退回发件人 |
| DE | 派送异常 |
| OP | 重新计划派送 |
| DD | 派送延时 |
| AC | 地址更新 |
货车定位查询
URL
POST https://gateway.uniner.com/open-api/api/trunk/v1/getTrunkLocation
描述
货车定位查询
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| beginDt | string | 否 | 开始时间yyyy-MM-dd HH:mm:ss |
| endDt | string | 否 | 结束时间yyyy-MM-dd HH:mm:ss |
| minusHours | int32 | 否 | 当前时间与历史时间差 beginDt 及 beginDt 为空是启用，默认最近12小时 |
| requestDT | int64 | 是 | 请求时间戳 |
| sign | string | 是 | 签名 |
| trunkInfo | string | 是 | 车牌号 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| status | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| result | map | 返回结果 |
| gtm | object | GPS 时间 |
| lat | string | 纬度-单位：1/600000.0 WGS84 坐标系 |
| lon | string | 经度-单位：1/600000.0 WGS84 坐标系 |
| spd | string | 速度-单位：除以 10 之后，单位为 km/h,即(1/10.0)km/h，保留 1 位小数 |
| mlg | string | 里程-单位：百米，除以 10 之后， 单位为 km,(当>=0 时，需除以 10 换算成实 际里程，单位为 km，否则为 0) |
| hgt | string | 海拔 -单位：m |
| agl | string | 正北方向夹角-（0--359 ，正北为 0，顺时针） |
| map | map | No comments found. |
| any object | object | any object. |
磅单识别
URL
POST https://kj.uniner.com/open-api/api/document/weightlist
描述
磅单识别
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| requestDT | int64 | 是 | 请求时间戳 |
| file | file | 是 | 需要识别的文档，支持图片以及pdf，建议首选图片 |
| schema | string | 是 | 需要提取的关键词,多个用;分割 |
| ocrLang | string | 是 | 识别的语言 |
| layoutAnalysis | string | 是 | False |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| code | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| result | obj | 识别结果 |
报关单识别
URL
POST https://kj.uniner.com/open-api/api/document/customs
描述
报关单识别
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| requestDT | int64 | 是 | 请求时间戳 |
| file | file | 是 | 需要识别的文档，支持图片以及pdf，建议首选图片 |
| schema | string | 是 | 需要提取的关键词,多个用;分割 |
| ocrLang | string | 是 | 识别的语言 |
| analysisschemas | string | 是 | 需要使用版面分析的字段，无则默认只对“随附单证”使用 |
| blank | string | 是 | True |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| code | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| result | obj | 识别结果 |
海运托书/提单识别
URL
POST https://kj.uniner.com/open-api/api/document/hbl
描述
海运托书/提单识别
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| requestDT | int64 | 是 | 请求时间戳 |
| file | file | 是 | 需要识别的文档，支持图片以及pdf，建议首选图片 |
| schema | string | 是 | 需要提取的关键词,多个用;分割 |
| ocrLang | string | 是 | 识别的语言 |
| layoutAnalysis | string | 是 | False |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| code | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| result | obj | 识别结果 |
行驶证识别
URL
POST https://kj.uniner.com/open-api/api/document/drivingLicense
描述
行驶证识别
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| requestDT | int64 | 是 | 请求时间戳 |
| file | file | 是 | 需要识别的文档，支持图片以及pdf，建议首选图片 |
| schema | string | 是 | 需要提取的关键词,多个用;分割 |
| ocrLang | string | 是 | 识别的语言 |
| layoutAnalysis | string | 是 | False |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| code | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| result | obj | 识别结果 |
驾驶证识别
URL
POST https://kj.uniner.com/open-api/api/document/driverLicense
描述
驾驶证识别
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| requestDT | int64 | 是 | 请求时间戳 |
| file | file | 是 | 需要识别的文档，支持图片以及pdf，建议首选图片 |
| schema | string | 是 | 需要提取的关键词,多个用;分割 |
| ocrLang | string | 是 | 识别的语言 |
| layoutAnalysis | string | 是 | False |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| code | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| result | obj | 识别结果 |
身份证识别
URL
POST https://kj.uniner.com/open-api/api/document/identityCard
描述
身份证识别
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| requestDT | int64 | 是 | 请求时间戳 |
| file | file | 是 | 需要识别的文档，支持图片以及pdf，建议首选图片 |
| schema | string | 是 | 需要提取的关键词,多个用;分割 |
| ocrLang | string | 是 | 识别的语言 |
| layoutAnalysis | string | 是 | False |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| code | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| result | obj | 识别结果 |
道路运输许可证
URL
POST https://kj.uniner.com/open-api/api/document/roadTransportPermit
描述
道路运输许可证
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| requestDT | int64 | 是 | 请求时间戳 |
| file | file | 是 | 需要识别的文档，支持图片以及pdf，建议首选图片 |
| schema | string | 是 | 需要提取的关键词,多个用;分割 |
| ocrLang | string | 是 | 识别的语言 |
| layoutAnalysis | string | 是 | False |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| code | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| result | obj | 识别结果 |
从业资格证
URL
POST https://kj.uniner.com/open-api/api/document/qualification
描述
从业资格证
ContentType application/json; charset=utf-8
请求参数
Body Parameter
| 名称 | 类型 | 必填 | 描述 |
|---|
| appName | string | 是 | 应用名称 |
| requestDT | int64 | 是 | 请求时间戳 |
| file | file | 是 | 需要识别的文档，支持图片以及pdf，建议首选图片 |
| schema | string | 是 | 需要提取的关键词,多个用;分割 |
| ocrLang | string | 是 | 识别的语言 |
| layoutAnalysis | string | 是 | False |
| sign | string | 是 | 签名 |
响应参数
| 名称 | 类型 | 描述 |
|---|
| code | int32 | 返回状态 |
| message | string | 异常信息 |
| data | object | 正常返回结果信息 |
| result | obj | 识别结果 |
