Eyun 开发者文档

Appearance

POST{BASE_URL}/wx-api/webhook/test
写操作回调配置JSON · Bearer App Token

测试投递 ​

向当前回调地址推送一条 webhook.test 事件，返回推送结果（HTTP 状态/响应片段）。

说明与注意 ​

  • 测试失败时接口仍可能返回 HTTP 200，不能仅凭 HTTP 状态或 code=0 判断推送成功。 应同时检查 data.ok=true 且 data.httpStatus 为 2xx；data.ok=false 表示测试推送失败，按结果排查回调地址。

请求参数 ​

无请求参数。

请求示例 ​

http
POST {BASE_URL}/wx-api/webhook/test
Authorization: Bearer <你的 App Token>
Content-Type: application/json

{}
bash
curl -X POST '{BASE_URL}/wx-api/webhook/test' \
  -H 'Authorization: Bearer <你的 App Token>' \
  -H 'Content-Type: application/json' \
  --data-raw '{}'
python
import requests

url = "{BASE_URL}/wx-api/webhook/test"
headers = {"Authorization": "Bearer <你的 App Token>", "Content-Type": "application/json"}
body = """{}"""

resp = requests.post(url, headers=headers, data=body.encode("utf-8"))
print(resp.text)
java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String url = "{BASE_URL}/wx-api/webhook/test";
String body = "{}";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder(URI.create(url))
    .header("Authorization", "Bearer <你的 App Token>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
php
<?php

$url = '{BASE_URL}/wx-api/webhook/test';
$body = <<<'JSON'
{}
JSON;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer <你的 App Token>',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

响应示例 ​

json
{
  "code": 0,
  "data": {
    "ok": true,
    "eventType": "webhook.test",
    "httpStatus": 200
  },
  "message": "ok"
}

下一步 ​