开放 API

1接口地址

请求体支持 application/json、application/x-www-form-urlencoded 和 multipart/form-data 三种格式，字段名一致。 用浏览器直接打开接口地址会返回一段 JSON 提示（GET 不被接受）。

最快的一条命令

curl -X POST 'https://wm.huizhetao.com/openapi/' \
  -H 'Content-Type: application/json' \
  -d '{"action":"list","platform":"meituan","per":5}'

2请求参数

只返回在架活动，已下架/已删除的一律不出现，不需要额外过滤。

3返回结构

所有接口共用同一层外壳：

list 的 data

list 元素 · 美团（platform=meituan）

微信内或唤端被系统拦截时：deeplink 里 inner_url 参数解码后就是该活动的 click.meituan.com 官方落地页，任何浏览器都能打开， 可以拿它做兜底（本站详情页就是这么处理的）。

list 元素 · 饿了么（platform=eleme）

links 里可能出现的键（没生成的不会出现，取值前判空）： ele_word 淘宝闪购口令 · ele_deeplink 闪购唤起链接 · ele_h5url 闪购网页版 · tb_watchword 淘宝口令 · tb_h5url 淘宝网页版 · ali_watchword 支付宝口令 · ali_h5url 支付宝网页版 · wx_shortlink 微信短链

4返回示例

以下内容是写本文档时当场请求真实接口得到的，不是手写的示意数据 （… 处省略了同类条目）。

活动列表 · action=list&platform=meituan&per=2

{
    "code": 503,
    "msg": "接口已关闭",
    "data": null
}

统计与枚举 · action=stats

{
    "code": 503,
    "msg": "接口已关闭",
    "data": null
}

失败返回

{
    "code": 503,
    "msg": "接口已关闭",
    "data": null
}

5错误码

7调用示例

cURL

curl -X POST 'https://wm.huizhetao.com/openapi/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "list",
    "platform": "meituan",
    "biz": "waimai",
    "per": 20
  }'

PHP

$ch = curl_init('https://wm.huizhetao.com/openapi/');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'action'   => 'list',
        'platform' => 'meituan',
        'per'      => 20,
    ]),
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($res['code'] ?? -1) === 0) {
    foreach ($res['data']['list'] as $item) {
        echo $item['title'], ' → ', $item['h5_url'], PHP_EOL;
    }
}

JavaScript / 小程序

const res = await fetch('https://wm.huizhetao.com/openapi/', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ action: 'list', platform: 'meituan', per: 20 }),
});
const json = await res.json();
if (json.code === 0) {
  console.log(json.data.list);
}

Python

import requests

resp = requests.post('https://wm.huizhetao.com/openapi/', json={
    'action': 'list',
    'platform': 'meituan',
    'per': 20,
}, timeout=15)

data = resp.json()
if data['code'] == 0:
    for item in data['data']['list']:
        print(item['title'], item['h5_url'])

8使用约定

• 接口只读，不需要登录，也不会因为调用产生任何数据变更。
• 每个 IP 每分钟最多 60 次请求，请加本地缓存（活动数据每天更新几次， 建议缓存 5～10 分钟或更长）。
• 活动数据有版权与联盟归属，转发推广链接时请勿修改链接参数， 否则归属会失效。
• 返回的活动都在有效期内，但仍建议自行判断 end_date 后再展示。
• 接口随时可能增加新字段，解析时请忽略未知字段，不要写死字段清单。

对接中遇到问题，把完整的请求参数和返回 code / msg 发给站长即可定位。