# Get Mini Program Complaint Record
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 | type | Introductions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errcode | number | Return code | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
errmsg | string | Error message | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
records | array | List of complaints | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
# 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) toPOST
This 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 |