您的位置 : 文档中心 -> API信息

此接口支持多笔订单(暂定最多10笔每次)同时提交评价,并且只支持卖家向买家的评价,目前当某笔订单存在多个商品时,只能为这笔订单的这些商品提交相同的评价内容。

API用户授权类型

需要授权

系统级输入参数

名称 类型 是否必须 描述
_aop_timestamp String 请求时间戳
_aop_signature String 请求签名
access_token String 用户授权令牌

应用级输入参数

名称 类型 是否必须 描述 示例值 默认值
orders java.util.Map 订单评价:Map(String,TradeRateParam[]),前者为订单号,后者为评价内容与星级,结构请看数据结构订单评价参数。 评价星级(starLevel)必须是1-5, 当starLevel < 4 时必须同时指定评价内容 参考下面api示例

返回结果

名称 类型 是否必须 描述 示例值
failedOrder java.util.Map 提交评价失败的订单Map(Long,String),前者为失败的订单号,后者为失败的错误码: 1 返回为空时,创建全部成功 2 没指定订单号及评价内容时,接口直接返回成功结果 3 当订单已经评价过时,接口直接返回成功结果,不做任何处理 4 当指定的订单不是指定postMemberId用户的订单是,接口直接返回成功结果,不做任何处理 5 当指定的订单不处于待评价状态时,接口直接返回成功结果,不做任何处理 提交成功返回值:{} 失败的格式参考api实例

返回结果

请求参数json格式

  {                     // 批量提交评价的订单
"92154312490525" : [ // 主订单1
{
"starLevel" : "1", // 星级
"content" : "差评的" // 评价内容                      
} ],
"92154312590525" : [ // 主订单2
{
"starLevel" : "5", // 星级
"content" : "好评的" // 评价内容 
} ]
} 

返回值json结构

  {
    “92154312490525” :"INVOKE_DUBBO_ERROR"  //评价失败的订单号 以及失败的错误码
} 

错误码

错误码 错误描述 解决方案
NULL_PARAM 指定的参数为空
INVALID_PARAM 指定的参数有误
INVOKE_DUBBO_ERROR 接口内部服务调用错误,请联系服务接口人
UPDATE_DATABASE_FAILED 提交评价失败,数据库异常

API工具

SDK 示例