# Get Mini Program Complaint Record

Debugging tools

Interface should be called on the server side, seeHattori API

# Interface Dxplaination

# Interface name

getAppealRecords

# Functional description

Call This API Can obtain the complaint record of the Mini Program. If you encounter problems during use, you canOpen Platform Service Provider ZonePosting exchanges.

# Note

Calling this interface requires the Mini Program to authorize the permission sets of 18 and 76 to a third-party platform.

# Calling mode

# HTTPS call


POST https://api.weixin.qq.com/wxa/getappealrecords?access_token=ACCESS_TOKEN 

# Third Party Invocation

  • The calling method and parameters are the same as HTTPS, only the calling token is different

  • The permission set id to which this interface belongs is: 76

  • After the service provider has been authorized with one of the permission sets, it can do so by usingauthorizer_access_TokenCalling on behalf of the merchant

# 初始值

attribute type Required Introductions
access_Token string yes Interface invokes the certificate, which is URL Parameters, non Body Parameters. useauthorizer_access_Token
illegal_record_id string yes Violation penalty record id (record id returned through getillegalrecords interface)

# Return parameters

attribute typeIntroductions
errcode number Return code
errmsg string Error message
records array List of complaints
attribute type Introductions
appeal_record_id number Complaint id
appeal_time number Time of appeal
appeal_count number Number of complaints
appeal_from number Source of complaint (0 - user, 1 - provider)
appeal_status number Status of complaint
audit_time number Audit time
audit_reason string Reasons for Audit Results
punish_description string Reasons for Punishment Description
materials array Violation and complaint materials
attribute type Introductions
illegal_material object Violation materials
attribute type Introductions
content string Content violation
content_url string Illegal links
appeal_material object Complaint materials (information provided in response to the offending material)
attribute type Introductions
reason string Grounds for complaint
proof_初始值_ids array List of documents(The corresponding material can be downloaded through the "Get Temporary Material" interface)

# Other Notes

# Appeal status appeal_Dxplaination of status

value meaning
1 Being processed
2 Appeal not approved
3 The complaint was adopted
4 The complaint was withdrawn

# Small Program Appeal Record Push

When the mini program initiates an appeal or the appeal review status changes, the WeChat server will receive messages and events from the third-party platform. The URL (filled in by a third-party platform when created) toPOSTThis notification is sent in a way.

To enhance security, postdata to hit the target xml Will use encryption and decryption at the time of the service request key To encrypt, seeEncryption and Decryption Technology Program, Decryption is required after receiving the push (seeMessage Encryption and Decryption Access Guide)。

In addition to the message notification, the third-party platform can also query the complaint record of the Mini Program through the interface.

# Field Dxplaination

parameter type Introductions
ToUserName string The Original Mini Program ID
FromUserName string The sender account number (a OpenID, where the sender is the system account)
CreateTime number Timestamp of message creation
MsgType string Message type event
Event string Event type, here is the wxa_appeal_record
appeal_record_id number Complaint id
appid string Mini Program id
appeal_time number Time of appeal
appeal_count number Number of complaints
appeal_from number Source of complaint (0 - user, 1 - provider)
appeal_status number Status of complaint
audit_time number Review time ("Processing" or "Revocation" status, does not return this field)
audit_reason string Reason for Audit Result ("Processing" or "Revocation" status, not returning this field)
punish_description string Reasons for Punishment Description
material object 初始值 Violation and complaint materials
illegal_material object Violation materials
content string Content violation
content_url string Illegal links
appeal_material object Complaint materials
reason string Grounds for complaint
proof_material_id string Complaint material id(Can be accessed through"Access to Temporary Material"Interface to download the corresponding material)

# Example after the push content is decrypted:

<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>wxaaaa</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>Alleged fraud</punish_description>
    <material>
        <illegal_material>
            <content>Violation 1</content>
            <content_url>https://xxxxx</content_url>
        </illegal_material>
        <appeal_material>
            <reason>The content is normal.</reason>
            <proof_material_id>xxxx</proof_material_id>
            <proof_material_id>yyyy</proof_material_id>
        </appeal_material>
    </material>
    <material>
        <illegal_material>
            <content>Violation 2</content>
            <content_url>https://yyyyy</content_url>
        </illegal_material>
        <appeal_material>
            <reason>The content is normal.</reason>
            <proof_material_id>zzzz</proof_material_id>
        </appeal_material>
    </material>
</xml>

# Call Example

Example Dxplaination: HTTPS requests

# Sample Request Data


{
    "illegal_record_id": "2_11100"
} 

# Return Data Example


{
    "errcode": 0,
    "errmsg": "ok",
    "records": [
        {
            "appeal_record_id": 4111001,
            "appeal_time": 1600055800,
            "appeal_from": 0,
            "appeal_status": 1,
            "punish_description": "the content is suspected of fraud."
            "materials": [
                {
                    "illegal_material": {
                        "content": " Violation 1, "
                        "content_url": "https://xxxxx"
                    },
                    "appeal_material": {
                        "reason": "The content is normal."
                        "proof_material_ids": [
                            "xxxx",
                            "xxxx"
                        ]
                    }
                },
                {
                    "illegal_material": {
                        "content": " Violation 2, "
                        "content_url": "https://yyyyy"
                    },
                    "appeal_material": {
                        "reason": "The content is normal."
                        "proof_material_ids": [
                            "zzzz"
                        ]
                    }
                }
            ]
        }
    ]
} 

# Error code

Error code Error code Solutions
-1 system error The system is busy, please wait for the developer to try again