推送 API

请求

POST /api/push/{token}

支持 application/json 和 application/x-www-form-urlencoded。

参数	说明
title	必填，去掉两端空白后 1–100 个字符
content	必填，最多 32 KiB UTF-8 文本，可使用 Markdown 或安全 HTML

可提供 Idempotency-Key 请求头；24 小时内，同一用户相同标识和内容返回原结果。同一标识用于不同内容返回 409。无幂等标识的每次请求独立计量。

JavaScript

const response = await fetch(process.env.QINGWA_PUSH_URL, {
  method: 'POST', headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({title: '任务完成', content: '处理成功'})
})
console.log(await response.json())

Go

body := strings.NewReader(`{"title":"任务完成","content":"处理成功"}`)
resp, err := http.Post(os.Getenv("QINGWA_PUSH_URL"), "application/json", body)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

成功响应 code 为 0，data 包含 status、used_today、daily_limit 和 remaining_today；request_id 用于定位问题。

状态

• 200：微信已受理。
• 202：结果待确认，请勿直接重发。
• 400：参数不合法。
• 401：Token 无效或已重置。
• 403：未关注。
• 409：幂等标识冲突。
• 429：日额度不足或请求过于频繁。
• 502/503：微信拒绝、配置未完成或暂不可用。