oTMS-openapi
  1. oTMS API
oTMS-openapi
  • oTMS API
    • 订单导入
      PUT
    • 订单导出/追踪
      POST
    • 提送货点导入
      PUT
    • 提送货点删除
      DELETE
    • 卡车和司机导入
      PUT
    • 订单分配司机
      POST
    • 运输单导入
      PUT
    • 运输单删除
      PUT
    • 订单外部追踪
      POST
    • 订单召回
      POST
    • 订单分享链接
      PUT
    • 承运商导出
      POST
    • h5链接
      PUT
    • 订单更新
      PUT
    • 订单费用更新
      POST
    • 订单分配
      POST
    • 车辆信息
      POST
    • 订单撤销
      PUT
    • 运输单分配司机
      PUT
    • 订单评分
      POST
    • 订单交接创建
      PUT
    • 订单自定义文本字段更新
      POST
    • 订单快速交接
      POST
    • 价格文件匹配
      POST
    • 收货方/发货方导出
      POST
    • 运输单导出/追踪
      POST
    • 运输单召回
      PUT
    • 文件上传
      POST
    • 订单事件推送
      PUT
    • 运输单事件推送
      PUT
    • 拒收导出
      POST
    • 收货码查询
      POST
    • 便携式设备导入
      POST
  1. oTMS API

便携式设备导入

POST
https://login.otms.cn/ws/incubatorAndTemperatureImport

便携式设备导入#

通过便携式设备导入接口,可以将不同便携式设备进行批量的导入
版本号文档说明
0.1当前版本文档

配置说明#

oTMS同时在生产环境和测试环境中提供Web Service接口,其中测试环境用于集成测试。两种环境下都需要由oTMS系统管理员分配API帐号密码后方可使用。
注意: 请合理地调用公共接口。如果发现存在异常调用或者对我们系统性能造成影响等情况,会对API账号的调用进行限制,甚至停用。
目前对该接口的调用限制为每个公司每秒最多3个请求(如需增加可选购增值服务)。

接口说明#

公共参数#

环境HTTP请求方法HTTPS请求地址请求主体MIME类型响应主体MIME类型
正式环境POSThttps://login.otms.cn/ws/deliveryCodeQueryapplication/jsonapplication/json
沙箱环境POSThttps://demo.otms.cn/ws/deliveryCodeQueryapplication/jsonapplication/json

请求参数#

字段名位置是否必填描述Schema
bodybody是OrderRequest

错误码解释#

全局反馈代码#

反馈代码说明
0客户验证失败。
1不支持的请求版本。

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Basic 之后拼接空格,以及经过 Base64 编码的 username:password
示例:
Authorization: Basic *****************
Body 参数application/json

示例
{
    "version": 0.1,
    "incubators": [
        {
            "sequence": 1,
            "companyName": "康沐辰",
            "deviceNumber": "supplier007",
            "companyNumber": "supplier007",
            "remarks": "minim Lorem",
            "active": true,
            "updateExists": false
        }
    ],
    "temperatures": [
        {
            "sequence": 1,
            "companyName": "秦玉兰",
            "deviceNumber": "wenkong007",
            "companyNumber": "wenkong01",
            "remarks": "reprehenderit nostrud ea",
            "active": true,
            "updateExists": false
        }
    ],
    "connects": [
        {
            "sequence": 1,
            "incubatorNumber": "supplier007",
            "temperatureNumber": "wenkong007"
        }
    ]
}

返回响应

🟢200成功
application/json
Body

示例
{
    "version": "0.1",
    "responseCode": "",
    "importedIncubators": 1,
    "importedTemperatures": 1,
    "bindIncubatorTemperatures": 1,
    "temperatureDetails": [
        {
            "sequence": 1,
            "importStatus": "SUCCEED",
            "deviceNumber": "wenkong006"
        }
    ],
    "incubatorDetails": [
        {
            "sequence": 1,
            "importStatus": "SUCCEED",
            "deviceNumber": "supplier006"
        }
    ],
    "connects": [
        {
            "sequence": 1,
            "importStatus": "SUCCEED",
            "deviceNumber": "supplier006"
        }
    ]
}
上一页
收货码查询
Built with