一封传话API文档 一封传话API文档
首页 (opens new window)
  • 三分钟快速接入
  • 弹幕接入

    • 弹幕快速体验
    • 一行代码集成弹幕
    • 浏览器弹幕挂件
  • 推送MCP
  • 推送skill
  • 快速开始

    • 使用php代码
    • 使用java代码
    • 使用python代码
    • 使用go代码
    • 使用csharp代码
    • 使用javascript代码
    • 使用nodejs代码
    • 客户端
    • 消息市场
  • API文档

    • 简介
    • 消息推送API
    • 发送提醒API
    • 电脑端在线调试API步骤
    • 一对多人推送功能
    • 一对多端推送通道
    • 在线测试以及消息查询API
    • Markdown语法
    • 推送日志与图表统计
    • 群组提醒用户注册与自动登录SDK
  • 浏览器插件

    • 浏览器插件
    • 浏览器挂件
  • 企业微信群机器人推送配置
  • 企业微信应用推送配置
  • 钉钉群机器人推送配置
  • 飞书群机器人推送配置
  • webhook推送配置
  • 官方邮件配置
  • 自定义SMTP邮件配置
  • 系统功能使用额度
  • 收不到消息如何排查
  • 消息内容如何换行
  • 卡片消息不显示正文
  • 接口是否支持https以及安全性
  • 是否支持群组功能
  • 是否支持多端提醒功能
  • 如何解决微信推送没有提示音的问题
  • 是否支持发送图片
  • 遇到乱码或者※号怎么办
  • 其他问题※号怎么办
  • 问题反馈
  • 关于
  • 友情链接

一封传话

专注于消息推送领域,提供极简API,一行代码即可帮您迅速完成消息的推送。
首页 (opens new window)
  • 三分钟快速接入
  • 弹幕接入

    • 弹幕快速体验
    • 一行代码集成弹幕
    • 浏览器弹幕挂件
  • 推送MCP
  • 推送skill
  • 快速开始

    • 使用php代码
    • 使用java代码
    • 使用python代码
    • 使用go代码
    • 使用csharp代码
    • 使用javascript代码
    • 使用nodejs代码
    • 客户端
    • 消息市场
  • API文档

    • 简介
    • 消息推送API
    • 发送提醒API
    • 电脑端在线调试API步骤
    • 一对多人推送功能
    • 一对多端推送通道
    • 在线测试以及消息查询API
    • Markdown语法
    • 推送日志与图表统计
    • 群组提醒用户注册与自动登录SDK
  • 浏览器插件

    • 浏览器插件
    • 浏览器挂件
  • 企业微信群机器人推送配置
  • 企业微信应用推送配置
  • 钉钉群机器人推送配置
  • 飞书群机器人推送配置
  • webhook推送配置
  • 官方邮件配置
  • 自定义SMTP邮件配置
  • 系统功能使用额度
  • 收不到消息如何排查
  • 消息内容如何换行
  • 卡片消息不显示正文
  • 接口是否支持https以及安全性
  • 是否支持群组功能
  • 是否支持多端提醒功能
  • 如何解决微信推送没有提示音的问题
  • 是否支持发送图片
  • 遇到乱码或者※号怎么办
  • 其他问题※号怎么办
  • 问题反馈
  • 关于
  • 友情链接
  • 新手快速开始

    • 三分钟快速接入
    • 弹幕快速体验
    • 一行代码集成弹幕
    • 浏览器弹幕挂件
  • MCP和skill

    • 推送MCP
    • 推送Skill
  • 快速开始

    • 简介
    • PHP语言
    • JAVA语言
    • Python语言
    • Go语言
    • C#语言
    • 客户端
    • JavaScript语言
      • 一、一行代码发送(jQuery)
      • 二、POST 发送(原生 fetch,无需任何库)
      • 三、POST 发送(XMLHttpRequest,兼容老旧浏览器)
      • 四、直接用于弹幕
    • Node.js语言
    • 错误代码
    • 消息市场
    • Github Actions插件
  • API文档

    • 简介
    • 消息推送API
    • 发送提醒API
    • 电脑端在线调试API步骤
    • 一对多人推送功能
    • 一对多端推送通道
    • 在线测试以及消息查询API
    • Markdown语法
    • 推送日志与图表统计
    • 群组提醒用户注册与自动登录SDK
  • 扩展应用

    • 浏览器插件
    • 浏览器挂件
  • 指南
  • 快速开始
一封传话
2026-09-11
目录

JavaScript语言

提示

本篇适用于浏览器环境的 JavaScript(网页、浏览器控制台、前端项目)。Node.js 服务端写法请看 使用 Node.js 代码。

# 一、一行代码发送(jQuery)

如果页面已经引入了 jQuery,一行 GET 即可发送(也是弹幕的发送方式):

<!-- 一行代码进行消息推送 -->
<script>
$.getJSON("https://www.phprm.com/services/push/trigger/你的通道码?head=这是标题&body=这是内容");
</script>
1
2
3
4

带中文参数时建议用 encodeURIComponent 编码:

var channelCode = "你的通道码";
var apiUrl = "https://www.phprm.com/services/push/trigger/" + channelCode
    + "?head=" + encodeURIComponent("这是标题")
    + "&body=" + encodeURIComponent("这是长内容");
$.getJSON(apiUrl, function (resp) {
    console.log("推送结果:", resp);
});
1
2
3
4
5
6
7

# 二、POST 发送(原生 fetch,无需任何库)

现代浏览器都内置了 fetch,推荐用 POST + JSON 方式发送较长内容:

async function sendPush(head, body, jumpUrl) {
    var channelCode = "你的通道码";
    var apiUrl = "https://www.phprm.com/services/push/send/" + channelCode;

    var payload = { head: head, body: body || "", url: jumpUrl || "" };

    var resp = await fetch(apiUrl, {
        method: "POST",
        headers: { "Content-Type": "application/json;charset=UTF-8" },
        body: JSON.stringify(payload)
    });

    var data = await resp.json();
    console.log("HTTP", resp.status, data);
    return data; // {"code":0,"message":"请求成功","data":{"messageIdList":[...]}}
}

// 调用
sendPush("构建完成", "**分支**: main\n**耗时**: 38s", "https://example.com/ci/123");
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# 三、POST 发送(XMLHttpRequest,兼容老旧浏览器)

function sendPush(head, body) {
    var channelCode = "你的通道码";
    var xhr = new XMLHttpRequest();
    xhr.open("POST", "https://www.phprm.com/services/push/send/" + channelCode, true);
    xhr.setRequestHeader("Content-Type", "application/json;charset=UTF-8");

    xhr.onreadystatechange = function () {
        if (xhr.readyState === 4) {
            console.log("HTTP", xhr.status, xhr.responseText);
        }
    };

    xhr.send(JSON.stringify({ head: head, body: body || "", url: "" }));
}

sendPush("测试标题", "测试内容");
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 四、直接用于弹幕

在已集成 danmu.js 的页面上,调用 trigger 接口发送的内容会实时以弹幕形式飘过所有在线页面:

fetch("https://www.phprm.com/services/push/trigger/你的通道码?head=" + encodeURIComponent("新公告:今晚8点维护"));
1

注意

  • 浏览器端代码会暴露通道码,仅适合在你自己可控的网页内部(如管理后台、内网页面)使用;公开页面建议由后端代发,或使用弹幕接入文档中的审核机制。
  • 通道码不要硬编码提交到公开的前端 git 仓库。
#Demo代码#JavaScript代码
Last Updated: 2026/09/11, 21:21:27
客户端
Node.js语言

← 客户端 Node.js语言→

最近更新
01
弹幕快速体验
09-11
02
一行代码集成弹幕
09-11
03
三分钟快速接入
09-11
更多文章>
Theme by Vdoing | Copyright © 2024-2026

友情链接:推送API | 推送移动版

Copyright © 2024 All rights reserved Powered by phprm.com版权所有 | 京ICP备14058182号-3
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式