订单评分

订单评分导入接口，一个请求最大支持100条rating记录。

版本号	文档	说明
0.1	当前版本文档

配置说明

oTMS同时在生产环境和测试环境中提供Web Service接口，其中测试环境用于集成测试。两种环境下都需要由oTMS系统管理员分配API帐号密码后方可使用。

注意: 请合理地调用公共接口。如果发现存在异常调用或者对我们系统性能造成影响等情况，会对API账号的调用进行限制，甚至停用。

目前对该接口的调用限制为每个公司每秒最多3个请求（如需增加可选购增值服务）

接口说明

公共参数

环境	HTTP请求方法	HTTPS请求地址	请求主体MIME类型	响应主体MIME类型
正式环境	POST	`https://login.otms.cn/ws/openapi/ratings`	application/xml	application/xml
沙箱环境	POST	`https://demo.otms.cn/ws/openapi/ratings`	application/xml	application/xml

请求参数

字段名	位置	是否必填	描述	Schema
body	body	是	订单评分数据导入请求	RatingImportRequest
Authorization	header	否	Basic Authorization。如果不为空，则优先使用该值作身份认证。否则使用请求报文中的用户名与密码	string

请求参数

Body 参数application/xml

示例

<?xml version="1.0" encoding="utf-8"?>
<externalRatingRequest version="1.0" login="username" password="password">
  <ratings>
    <ratingDetail sequence="1">
      <orderNumber>DYZZWDNW004205</orderNumber> 
      <rating>4</rating> 
      <latitude>31.230253</latitude> 
      <longitude>121.534672</longitude>
      <createdBy>tester@otms.com</createdBy>
      <createdAt>2025-03-20T01:02:03.045</createdAt>
      <remark>this is remark</remark>
    </ratingDetail> 
    <ratingDetail sequence="2">
      <orderNumber>DYZZWDNW004158</orderNumber>  
      <rating>4</rating> 
      <latitude>31.230253</latitude> 
      <longitude>121.534672</longitude>
      <createdBy>tester@otms.com</createdBy> 
      <createdAt>2025-03-15T01:02:03.045</createdAt>
      <remark>this is remark</remark>
    </ratingDetail>
  </ratings>
</externalRatingRequest>

返回响应

🟢200成功

application/xml

successful operation

Body

示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ratingImportResponse>
    <ratings>
        <ratingImportResult>
            <orderNumber>DYZZWDNW004205</orderNumber>
            <code>1000</code>
            <message>success</message>
        </ratingImportResult>
        <ratingImportResult>
            <orderNumber>DYZZWDNW004158</orderNumber>
            <code>1000</code>
            <message>success</message>
        </ratingImportResult>
    </ratings>
</ratingImportResponse>

订单评分

订单评分#

配置说明#

接口说明#

公共参数#

请求参数#

请求参数

返回响应

订单评分

配置说明

接口说明

公共参数

请求参数