微信事件回调 (POST)

POST

/auth/wechat-callback

接收微信推送的 XML 消息（关注、扫码、文本消息等），处理完成后必须返回 'success'。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Body 参数text/xml必填

示例

<?xml version="1.0" encoding="UTF-8"?>
<root>&lt;xml&gt;&lt;ToUserName&gt;&lt;![CDATA[gh_abcdef]]&gt;&lt;/ToUserName&gt;&lt;FromUserName&gt;&lt;![CDATA[oABCD]]&gt;&lt;/FromUserName&gt;&lt;CreateTime&gt;123456789&lt;/CreateTime&gt;&lt;MsgType&gt;&lt;![CDATA[event]]&gt;&lt;/MsgType&gt;&lt;Event&gt;&lt;![CDATA[subscribe]]&gt;&lt;/Event&gt;&lt;/xml&gt;</root>

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/auth/wechat-callback?signature&timestamp&nonce&encrypt_type&msg_signature' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: text/xml' \
--data-raw '<?xml version="1.0" encoding="UTF-8"?>
<root>&lt;xml&gt;&lt;ToUserName&gt;&lt;![CDATA[gh_abcdef]]&gt;&lt;/ToUserName&gt;&lt;FromUserName&gt;&lt;![CDATA[oABCD]]&gt;&lt;/FromUserName&gt;&lt;CreateTime&gt;123456789&lt;/CreateTime&gt;&lt;MsgType&gt;&lt;![CDATA[event]]&gt;&lt;/MsgType&gt;&lt;Event&gt;&lt;![CDATA[subscribe]]&gt;&lt;/Event&gt;&lt;/xml&gt;</root>'

返回响应

🟢200

text/plain

成功响应（success）

Body

示例

"success"

修改于 2026-02-10 11:28:24

微信服务器验证 (GET)

微信获取二维码