开放平台
取消
开放平台
中文
EN
取消
  • 第三方平台 API

    • # 获取小程序申诉记录

    调试诊断

    接口应在服务器端调用，详细说明参见服务端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_record_id number 申诉单id
    appeal_time number 申诉时间
    appeal_count number 申诉次数
    appeal_from number 申诉来源（0--用户，1--服务商）
    appeal_status number 申诉状态
    audit_time number 审核时间
    audit_reason string 审核结果理由
    punish_description string 处罚原因描述
    materials array<object> 违规材料和申诉材料
    属性 类型 说明
    illegal_material object 违规材料
    属性 类型 说明
    content string 违规内容
    content_url string 违规链接
    appeal_material object 申诉材料（针对违规材料提供的资料）
    属性 类型 说明
    reason string 申诉理由
    proof_material_ids array<string> 证明材料列表(可以通过“获取临时素材”接口下载对应的材料）

    # 其他说明

    # 申诉状态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 系统繁忙，此时请开发者稍候再试