# 获取小程序交易体验分违规记录

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

接口英文名：GetPenaltyList

获取小程序交易体验分违规记录

# 1. 调用方式

# HTTPS 调用

GET https://api.weixin.qq.com/wxaapi/wxamptrade/get_penalty_list?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用

# 第三方调用

本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：151
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token、authorizer_access_token

# 请求体 `Request Payload`

参数名	类型	必填	说明
offset	number	是	获取从第offset条开始的limit条记录（序号从 0 开始），最大不超过总记录数
limit	number	是	获取从第offset条开始的limit条记录（序号从 0 开始），最大不超过 100

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
appealList	objarray	记录列表
currentScore	number	当前小程序的交易体验分
totalNum	number	当前小程序的总扣分记录数

# Res.appealList(Array) `Object Payload`

记录列表

参数名	类型	说明	枚举
illegalOrderId	number	扣分记录ID	-
complaintOrderId	number	投诉单ID	-
illegalWording	string	违规行为	-
status	number	扣分记录状态	枚举值
minusScore	number	扣除分数	-
orderId	number	订单号	-
illegalTime	number	扣分记录创建时间	-
updateTime	number	更新时间	-

# 4. 枚举信息

# Res.appealList(Array).status `Enum`

扣分记录状态

枚举值	描述
2	扣分审批通过
4	申诉中
5	申述驳回
6	申诉成功

# 5. 注意事项

本接口无特殊注意事项

# 6. 代码示例

请求示例

GET https://api.weixin.qq.com/wxaapi/wxamptrade/get_penalty_list?access_token=xxx&offset=0&limit=10

返回示例

{
    "appealList": [
        {
            "illegalOrderId": "12345",
            "complaintOrderId": "54321",
            "illegalWording": "质量缺陷",
            "status": 6,
            "illegalTime": 1656658706,
            "orderId": "payorder@567897862897364928374",
            "minusScore": 2,
            "updateTime": 1656907435
        },
        {
            "illegalOrderId": "61577",
            "complaintOrderId": "1360130",
            "illegalWording": "骚扰/辱骂他人",
            "status": 5,
            "illegalTime": 1656658601,
            "orderId": "payorder@_4200001450202207012836130249",
            "minusScore": 20,
            "updateTime": 1656659715
        }
    ],
    "currentScore": 55,
    "totalNum": 2,
    "errcode": 0
}

# 7. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述
20002	参数非法
200002	参数错误

# 8. 适用范围

本接口支持「小程序」账号类型调用。其他账号类型如无特殊说明，均不可调用。

# 获取小程序交易体验分违规记录

# 1. 调用方式

# HTTPS 调用

# 云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# Res.appealList(Array) Object Payload

# 4. 枚举信息

# Res.appealList(Array).status Enum

# 5. 注意事项

# 6. 代码示例

# 7. 错误码

# 8. 适用范围

# 查询参数 `Query String parameters`

# 请求体 `Request Payload`

# 返回体 `Response Payload`

# Res.appealList(Array) `Object Payload`

# Res.appealList(Array).status `Enum`