@badge-sdk/web

中文文档
0.4.1发布于 2026/08/26MITTypeScriptESM + CJS近 30 天下载 2.2万

在您现有的应用程序中嵌入徽章的移动钱包管理功能 .

中文使用文档
文档目录6 节
  1. 什么是徽章吗?
  2. 谁用徽章?
  3. 使用量
  4. Bundler 支持系统
  5. 浏览器支持
  6. 许可证

@ badge-sdk/ web (英语)

@badge-sdk/web 允许您嵌入徽章 移动钱包管理功能 在您的网络应用程序中。 完整的SDK文件访问: https://docs.trybadge.com/docs/sdk (中文(简体) )

关于徽章平台的信息,请检查我们的 网站 财务报告和审定财务报表 文档。 。 。 .

什么是徽章吗?

徽章, 允许平台将徽章的无码 UI 版本嵌入您的网页 应用程序或 SaaS 平台为您的客户提供移动钱包.

有了徽章,您可以提供客户 通过编辑,管理, 和运动不离开你的产品.

谁用徽章?

徽章是为各种规模的企业建造的,这些企业想利用 移动钱包.

无论你是一个小生意 寻求增强客户经验还是 大企业试图推动新的收入来源,徽章提供了工具 以及实现你目标的灵活性.

我们提供定制选项和支持,以创建定制钱包 与你的品牌、行业和具体 营销目标.

使用量

为了使用SDK,你需要一个 标签工作空间 还有一个 SDK 键。 。 。 .

有了SDK Token,徽章SDK就可以被初始化:

import * as badge from "@badge-sdk/web";

const badgeSdk = badge.makeSdk({token: badgeToken});

SDK现在可以用来嵌入一个通关模板:

<div id="badge-template" style="height:100%">Loading...</div>
badge.embedTemplatePage(
  badgeSdk,
  window.document.getElementById("badge-template"),
  {
    templateId: templateId,
    features: {
      passList: true,
      templateEditor: true,
    },
  },
);

通过设置属性,可以启用多种特性 features。更多详情可在 SDK 配置文件。 。 。 .

嵌入层外观也可以被定制. 其他细节可以是: 发现于 SDK 配置文件。 。 。 .

Bundler 支持系统

货包同时装有ES模块(dist/index.js)和一个UMD建筑 (单位:千美元)dist/index.umd.cjs),所有依赖关系被捆绑. 捆绑的类型脚本 包括了声明,因此没有单独的 @types 需要软件包.

不需要捆绑。 UMD 构建可直接从脚本中加载 通过任何 npm CDN 标记,将 SDK 暴露为全局 badge数字 :

<script src="https://unpkg.com/@badge-sdk/web"></script>
<script>
  const badgeSdk = badge.makeSdk({token: badgeToken});
</script>

浏览器支持

SDK作为ES2020发布,并支持以下最小浏览器 版本 :

  • 87+克罗梅
  • 边缘88+
  • Firefox 78+ (英语)
  • Safari 14+(包括iOS 14+上的Safari)

基于铬的浏览器如歌剧,勇者,和三星互联网都得到了支持 从对应于Chrome 87. 的释放。 旧浏览器需要您自己的 转接和多填充.

许可证

这个寄存器是麻省理工学院许可的.

版本与发布记录

@badge-sdk/web 共发布 10 个版本,首次发布于 2025/01/18;过去 12 个月发布了 3 个版本。

版本发布日期距今
0.4.1latest2026/08/262 个月前
0.4.02026/08/152 个月前
0.3.02026/02/039 个月前
0.2.02025/06/271.4 年前
0.1.12025/05/031.5 年前
0.1.02025/05/011.5 年前

其他发布通道:alpha → 0.1.0-alpha.3。

关于 @badge-sdk/web 的常见问题

@badge-sdk/web 是什么?

在您现有的应用程序中嵌入徽章的移动钱包管理功能 .

如何安装 @badge-sdk/web?

在项目目录运行 npm install @badge-sdk/web,或使用 pnpm add / yarn add / bun add。

@badge-sdk/web 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@badge-sdk/web 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@badge-sdk/web 可以商用吗?

@badge-sdk/web 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@badge-sdk/web 的下载量有多少?

根据 npm 官方下载统计,@badge-sdk/web 在 2026/10/08 – 2026/11/06 这 30 天内被下载 21,637 次,日均约 721 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@badge-sdk/web 还在维护吗?

最新版本 0.4.1 发布于 2026/08/26(2 个月前);至今共发布 10 个版本,其中过去 12 个月发布了 3 个;首次发布于 2025/01/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。