SuperAPI AI 工具集

twilio

测试与质量

查看项目

更新于 10-16 01:15

技能介绍

用途:在本地开发和测试中模拟 Twilio REST API,避免调用真实短信、语音等付费服务。

主要能力:提供有状态的账号、Auth Token、API Key、来电号码、Programmable Messaging、Messaging Services、Verify、基础 Voice 通话、Conversations REST 资源、签名 Webhook、本地模拟路由和检查器。

使用方式:运行 npx emulate --service twilio 启动。默认监听 127.0.0.1,容器或其他机器访问需传 --host 0.0.0.0 或在 createEmulator 中设 hostname: '0.0.0.0',并用 --base-url 或 baseUrl 配置对外可达地址。全部服务启动时默认 URL 为 http://localhost:4013,仅 Twilio 时为 http://localhost:4000。默认凭据包括 TWILIO_ACCOUNT_SID=AC00000000000000000000000000000000、TWILIO_AUTH_TOKEN=twilio_test_auth_token、TWILIO_API_KEY=SK00000000000000000000000000000000、TWILIO_API_SECRET=twilio_test_api_secret、TWILIO_PHONE_NUMBER=+15551234567、TWILIO_VERIFY_SERVICE_SID=VA00000000000000000000000000000000。真实 URL 需映射到模拟器前缀,如 https://api.twilio.com/2010-04-01/... 对应 $TWILIO_EMULATOR_URL/2010-04-01/...,messaging 与 verify 同理。官方 Node SDK 会构造绝对 URL,测试时需自定义请求客户端重写主机。认证支持 Account SID + Auth Token 或 API Key SID + Secret 的 HTTP Basic。

核心路由:创建/列出消息、创建外呼、启动与校验 Verify、创建 Conversation、添加参与者与消息,以及 /_twilio/simulate/ 下的入站短信、消息状态、入站通话等模拟端点。Verify 种子验证码为 123456,可用 CustomCode 强制指定,也可通过 GET /_twilio/simulate/verification-code 获取本地验证码。

限制:未实现真实短信、MMS、WhatsApp、邮件、语音、运营商、合规、计费、SendGrid、Studio、Flex、TaskRouter、Video、Sync、Segment、Conversations SDK WebSocket 及完整 TwiML 解释器行为。

自定义模拟器:可用 npx emulate init --custom inventory 生成第三方 API 模拟器,在 emulate.config.ts 中通过 defineConfig 注册,与 { emulator: "twilio" } 等内置项并列,运行 npx emulate start --watch 重载并在 /_emulate 检查状态。