开放数据通道 · Webhook 自助接入

注册一个回调地址，我们每 2 小时把平台真实成交与商机摘要（HMAC-SHA256 签名）直接推给你。
免费、即时生效、无需审核 —— 机器对机器，零人工干预。

三步接入

STEP 1

在下方提交你的 HTTPS / HTTP 回调地址，得到专属签名密钥 secret。

STEP 2

按 sha256=HMAC(secret, 原始请求体) 校验 X-ILUME-Signature 头。

STEP 3

返回 200 即确认。之后每 2 小时自动推送，无需再配置。

协议约定

项目	说明
请求方法	POST `Content-Type: application/json; charset=utf-8`
事件头	`X-ILUME-Event: ilume.deal.digest`
签名头	`X-ILUME-Signature: sha256=<hex(HMAC_SHA256(secret, raw_body))>`
频率	每 2 小时一次（可通过 `?tag=` 分组按标签定向推送）
超时 / 重试	单次超时 12 秒；失败累计计入 `fail`，不影响其他订阅方
数据范围	平台公开的撮合成交与商机摘要（走廊、品类、数量、估值区间），不含个人信息
退订	回调地址返回 410，或联系 service@ilumegroup.cn，即刻停止

推送载荷样例

{
  "type": "ilume.deal.digest",
  "ts": 1786000000,
  "site": "https://ilumegroup.cn",
  "subscribe": "https://ilumegroup.cn/subscribe",
  "n": 28,
  "items": [
    { "kind": "quote", "ref": "Q2026-...-001", "lane": "CN→NL 钢材", "ts": "..." },
    { "kind": "pool",  "lane": "一带一路 建材", "count": 128, "est_value": 4620000 }
  ]
}

校验示例

务必用 原始请求体字节 计算，不要用反序列化后再序列化的字符串。

# Python (FastAPI / Flask)
import hmac, hashlib
def verify(secret: str, raw: bytes, sig_header: str) -> bool:
    calc = "sha256=" + hmac.new(secret.encode(), raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(calc, sig_header)

# Node.js (Express)
const crypto = require("crypto");
app.post("/ilume-hook", express.raw({type:"*/*"}), (req, res) => {
  const calc = "sha256=" + crypto.createHmac("sha256", SECRET).update(req.body).digest("hex");
  if (calc !== req.get("X-ILUME-Signature")) return res.sendStatus(401);
  console.log(JSON.parse(req.body.toString())); res.sendStatus(200);
});

# curl 自测
curl -X POST "https://ilumegroup.cn/datastore/webhook/sub" \
     -H "Content-Type: application/json" \
     -d '{"url":"https://your-domain.com/ilume-hook","tag":"my-crm"}'

立即注册（免审核 · 即时生效）

回调地址（你的服务端 URL）标签（可选，用于定向推送分组）

密钥仅在你注册时返回一次，请立即保存到你的服务端环境变量中。

配套的另外两条直达通道

通道	用法
浏览器推送	访客在任意页面点击「开启推送」即可订阅，无需 App、无需邮箱；订阅页与全站浮条均可开通。
邮件情报	每周一封精选全球商机与合规窗口，点此订阅，随时一键退订。

ILUME GROUP 壹路生态 · ilumegroup.cn · 技术与商务对接：service@ilumegroup.cn · 客服