# 获取小程序申诉记录
接口应在服务器端调用，详细说明参见服务端API。
# 接口说明
# 接口英文名
getAppealRecords
# 功能描述
调用本 API 可以获取小程序的申诉记录。使用过程中如遇到问题，可在开放平台服务商专区发帖交流。
# 注意事项
调用该接口，需要小程序将18、76的权限集授权给第三方平台；
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/getappealrecords?access_token=ACCESS_TOKEN
# 第三方调用
调用方式以及出入参和HTTPS相同，仅是调用的token不同
该接口所属的权限集id为：76
服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用
# 请求参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证，该参数为 URL 参数，非 Body 参数。使用authorizer_access_token |
| illegal_record_id | string | 是 | 违规处罚记录id（通过getillegalrecords接口返回的记录id） |
# 返回参数
| 属性 | 类型 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| errcode | number | 返回码 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| errmsg | string | 错误信息 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| records | array<object> | 申诉记录列表 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
# 其他说明
# 申诉状态appeal_status说明
| 值 | 含义 |
|---|---|
| 1 | 正在处理 |
| 2 | 申诉不通过 |
| 3 | 申诉通过 |
| 4 | 申诉已撤销 |
# 小程序申诉记录推送
当小程序发起申诉或者申诉审核状态改变后，微信服务器会向第三方平台的消息与事件接收 URL（创建时由第三方平台填写）以POST的方式推送该通知，详情见消息推送文档。
除了消息通知之外，第三方平台也可通过接口查询小程序的申诉记录。
# 字段说明
| 参数 | 类型 | 说明 |
|---|---|---|
| ToUserName | string | 小程序的原始 ID |
| FromUserName | string | 发送方账号（一个 OpenID，此时发送方是系统账号） |
| CreateTime | number | 消息创建的时间戳 |
| MsgType | string | 消息类型 event |
| Event | string | 事件类型，这里是wxa_appeal_record |
| appeal_record_id | number | 申诉单id |
| appid | string | 小程序id |
| appeal_time | number | 申诉时间 |
| appeal_count | number | 申诉次数 |
| appeal_from | number | 申诉来源（0--用户，1--服务商） |
| appeal_status | number | 申诉状态 |
| audit_time | number | 审核时间（“正在处理”或者“撤销”状态，不返回该字段） |
| audit_reason | string | 审核结果理由（“正在处理”或者“撤销”状态，不返回该字段） |
| punish_description | string | 处罚原因描述 |
| material | object array | 违规材料和申诉材料 |
| illegal_material | object | 违规材料 |
| content | string | 违规内容 |
| content_url | string | 违规链接 |
| appeal_material | object | 申诉材料 |
| reason | string | 申诉理由 |
| proof_material_id | string | 申诉材料id(可以通过“获取临时素材”接口下载对应的材料） |
# 推送内容解密后的示例：
<xml>
<ToUserName><![CDATA[gh_fxxxxxxxa4b2]]></ToUserName>
<FromUserName><![CDATA[odxxxxM-xxxxxxxx-trm4a7apsU8]]></FromUserName>
<CreateTime>1600055810</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[wxa_appeal_record]]></Event>
<appeal_record_id>4111001</appeal_record_id>
<appid>wxaaaaaaaaaaaaaaaa</appid>
<appeal_time>1600055800</appeal_time>
<appeal_count>1</appeal_count>
<appeal_from>0</appeal_from>
<appeal_status>1|2|3|4</appeal_status>
<punish_description>内容涉嫌欺诈</punish_description>
<material>
<illegal_material>
<content>违规内容1</content>
<content_url>https://xxxxx</content_url>
</illegal_material>
<appeal_material>
<reason>内容是正常的</reason>
<proof_material_id>xxxx</proof_material_id>
<proof_material_id>yyyy</proof_material_id>
</appeal_material>
</material>
<material>
<illegal_material>
<content>违规内容2</content>
<content_url>https://yyyyy</content_url>
</illegal_material>
<appeal_material>
<reason>内容是正常的</reason>
<proof_material_id>zzzz</proof_material_id>
</appeal_material>
</material>
</xml>
# 调用示例
示例说明: HTTPS请求
# 请求数据示例
{
"illegal_record_id": "2_11100"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"records": [
{
"appeal_record_id": 4111001,
"appeal_time": 1600055800,
"appeal_from": 0,
"appeal_status": 1,
"punish_description": "内容涉嫌欺诈",
"materials": [
{
"illegal_material": {
"content": "违规内容1”,
"content_url": "https://xxxxx"
},
"appeal_material": {
"reason": "内容是正常的",
"proof_material_ids": [
"xxxx",
"xxxx"
]
}
},
{
"illegal_material": {
"content": "违规内容2”,
"content_url": "https://yyyyy"
},
"appeal_material": {
"reason": "内容是正常的",
"proof_material_ids": [
"zzzz"
]
}
}
]
}
]
}
# 错误码
| 错误码 | 错误码取值 | 解决方案 |
|---|---|---|
| -1 | system error | 系统繁忙，此时请开发者稍候再试 |