# 创建申诉

调试诊断

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

接口英文名：createAppeal

第三方平台在获得商家授权后，代小程序为指定违规记录提交申诉说明与证明材料；提交成功将消耗申诉次数，审核结果可通过事件推送或查询申诉记录获取。

# 1. 调用方式

# HTTPS 调用

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

# 云调用

• 本接口不支持云调用。

# 第三方调用

• 本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# Body.appeal_materials(Array) Object Payload

申诉材料列表，不能为空，且元素数量须与该违规记录包含的违规材料数量一一对应

# 3. 返回参数

# 返回体 Response Payload

# 4. 注意事项

• illegal_record_id 须为获取违规记录 返回的有效记录 id。
• appeal_materials 不能为空，且元素数量须与违规记录中的违规材料逐项对应；每项须同时填写 reason 与 proof_material_ids。
• reason（申诉理由）、proof_material_ids（申诉材料）均为必填；proof_material_ids 须为 上传临时素材 返回的 media_id 列表。
• 提交成功将消耗申诉次数；同步返回仅表示本次提交是否受理，不含申诉单详情。
• 同一违规若已有处理中申诉，不可重复提交；商家仍可在公众平台自行申诉，审核中互斥。
• 是否可再次申诉以当前申诉状态为准；不可申诉时返回对应错误码。

# 5. 代码示例

请求示例

{
  "illegal_record_id": "3_24911818",
  "appeal_materials": [
    {
      "reason": "申诉理由说明",
      "proof_material_ids": ["MEDIA_ID_1", "MEDIA_ID_2"]
    }
  ]
}

返回示例

{
  "errcode": 0,
  "errmsg": "ok"
}

# 6. 错误码

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

# 7. 适用范围

本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请以实际调用情况为准。