开发者

几分钟内从零到送达

一份尊重你时间的快速上手指南——支持邮箱由工程师亲自阅读。

01

创建 API 密钥

注册后打开控制台，生成 token + secret 密钥对。测试环境密钥免费。

# Console → API Keys → Create
$ boni keys create --label production
token   bni_live_9f2c41d8a7e64b05
secret  sk_live_•••••••••••••••• (shown once)

02

安装 SDK

Node.js 与 Python 官方客户端，每次发布都从 OpenAPI 规范自动生成。

$ pnpm add @boni/sdk
# or
$ pip install boni

03

发送第一条消息

一次调用、一个 Webhook，送达回执包含在内。响应会直接告诉你成本与延迟。

import { Boni } from "@boni/sdk";

const boni = new Boni(process.env.BONI_KEY);

await boni.messages.send({
  channel: "sms",
  to: "+13035550164",
  body: "Hello from Boni 👋",
});

04

校验 Webhook

每个事件都带 HMAC 签名。一个辅助函数即可校验，漏掉的事件可在控制台重放。

import { verifyWebhook } from "@boni/sdk/webhooks";

export async function POST(req: Request) {
  const event = await verifyWebhook(req, process.env.BONI_WEBHOOK_SECRET);

  if (event.type === "message.delivered") {
    console.log(event.data.id, event.data.latency_ms);
  }
  return new Response("ok");
}

API 参考

每个端点、参数与错误码。

状态页

实时可用性与事故历史。

更新日志

每周发布了什么，一目了然。

工程师支持

[email protected]——真人回复，不是机器人。