Back to Details

twilio

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Twilio API Emulator

Twilio API模拟器

Stateful Twilio REST emulation with seeded accounts, Auth Tokens, API keys, incoming phone numbers, Programmable Messaging, Messaging Services, Verify, basic Voice calls, Conversations REST resources, signed webhooks, local simulator routes, and an inspector.
具备状态的Twilio REST模拟功能，包含预配置账户、Auth Token、API密钥、来电号码、可编程消息、消息服务、Verify、基础语音通话、Conversations REST资源、签名Webhook、本地模拟器路由以及检查器。

Start

启动

bash
npx emulate --service twilio
Default URL: 
http://localhost:4013
when all services are started, or 
http://localhost:4000
when Twilio is the only service.
bash
npx emulate --service twilio
默认URL：当启动所有服务时为
http://localhost:4013
，当仅启动Twilio服务时为
http://localhost:4000
。

Defaults

默认配置

text
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
text
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 Mapping

URL映射

Real Twilio URLEmulator URL
https://api.twilio.com/2010-04-01/...
$TWILIO_EMULATOR_URL/2010-04-01/...
https://messaging.twilio.com/v1/...
$TWILIO_EMULATOR_URL/messaging/v1/...
https://verify.twilio.com/v2/...
$TWILIO_EMULATOR_URL/verify/v2/...
The official Node SDK builds absolute Twilio product URLs. In SDK tests, use a custom request client that rewrites those hosts to the emulator prefixes above.
真实Twilio URL模拟器URL
https://api.twilio.com/2010-04-01/...
$TWILIO_EMULATOR_URL/2010-04-01/...
https://messaging.twilio.com/v1/...
$TWILIO_EMULATOR_URL/messaging/v1/...
https://verify.twilio.com/v2/...
$TWILIO_EMULATOR_URL/verify/v2/...
官方Node SDK会构建Twilio产品的绝对URL。在SDK测试中，请使用自定义请求客户端将这些主机重写为上述模拟器前缀。

Auth

认证

HTTP Basic auth accepts either:
  • Account SID and Auth Token
  • API Key SID and API Key Secret
HTTP基础认证支持以下两种方式：
  • 账户SID和Auth Token
  • API密钥SID和API密钥Secret

Core Routes

核心路由

  • POST /2010-04-01/Accounts/{AccountSid}/Messages.json
    - create outbound message
  • GET /2010-04-01/Accounts/{AccountSid}/Messages.json
    - list messages
  • POST /2010-04-01/Accounts/{AccountSid}/Calls.json
    - create outbound call
  • POST /verify/v2/Services/{ServiceSid}/Verifications
    - start verification
  • POST /verify/v2/Services/{ServiceSid}/VerificationCheck
    - check verification code
  • POST /conversations/v1/Services/{ServiceSid}/Conversations
    - create Conversation
  • POST /conversations/v1/Services/{ServiceSid}/Conversations/{ConversationSid}/Participants
    - add participant
  • POST /conversations/v1/Services/{ServiceSid}/Conversations/{ConversationSid}/Messages
    - add message
  • POST /_twilio/simulate/inbound-message
    - simulate inbound SMS
  • POST /_twilio/simulate/message-status
    - simulate message status callback
  • POST /_twilio/simulate/inbound-call
    - simulate inbound call
  • POST /2010-04-01/Accounts/{AccountSid}/Messages.json
    - 创建出站消息
  • GET /2010-04-01/Accounts/{AccountSid}/Messages.json
    - 列出消息
  • POST /2010-04-01/Accounts/{AccountSid}/Calls.json
    - 创建出站通话
  • POST /verify/v2/Services/{ServiceSid}/Verifications
    - 启动验证
  • POST /verify/v2/Services/{ServiceSid}/VerificationCheck
    - 检查验证码
  • POST /conversations/v1/Services/{ServiceSid}/Conversations
    - 创建对话
  • POST /conversations/v1/Services/{ServiceSid}/Conversations/{ConversationSid}/Participants
    - 添加参与者
  • POST /conversations/v1/Services/{ServiceSid}/Conversations/{ConversationSid}/Messages
    - 添加消息
  • POST /_twilio/simulate/inbound-message
    - 模拟入站SMS
  • POST /_twilio/simulate/message-status
    - 模拟消息状态回调
  • POST /_twilio/simulate/inbound-call
    - 模拟入站通话

SMS And OTP Testing

SMS与OTP测试

  • The seeded Verify Service code is 
    123456
    .
  • Use 
    CustomCode
    when creating a Verification to force a per-verification code.
  • Use 
    GET /_twilio/simulate/verification-code?To=...&ServiceSid=...
    with Basic auth to fetch the latest local code for an E2E test.
  • Use 
    POST /_twilio/simulate/verification-status
    with 
    VerificationSid
    or 
    To
    to force local Verify state.
  • Use 
    POST /_twilio/simulate/inbound-message
    to test inbound SMS webhooks.
  • Inbound SMS uses an assigned Messaging Service 
    inbound_request_url
    before falling back to the phone number 
    sms_url
    .
  • Use 
    POST /_twilio/simulate/message-status
    to test outbound status callbacks.
  • 预配置的Verify服务验证码为
    123456
    。
  • 创建验证时使用
    CustomCode
    可强制设置单次验证的验证码。
  • 使用基础认证调用
    GET /_twilio/simulate/verification-code?To=...&ServiceSid=...
    ，可获取端到端测试的最新本地验证码。
  • 使用
    POST /_twilio/simulate/verification-status
    并传入
    VerificationSid
    或
    To
    ，可强制设置本地Verify状态。
  • 使用
    POST /_twilio/simulate/inbound-message
    测试入站SMS Webhook。
  • 入站SMS优先使用分配的消息服务
    inbound_request_url
    ，若不存在则回退至电话号码的
    sms_url
    。
  • 使用
    POST /_twilio/simulate/message-status
    测试出站状态回调。

Current Limits

当前限制

No real SMS, MMS, WhatsApp, email, voice, carrier, compliance, billing, SendGrid, Studio, Flex, TaskRouter, Video, Sync, Segment, Conversations SDK websocket behavior, or complete TwiML interpreter behavior is implemented.
未实现真实的SMS、MMS、WhatsApp、邮件、语音、运营商、合规、计费、SendGrid、Studio、Flex、TaskRouter、Video、Sync、Segment、Conversations SDK WebSocket行为，以及完整的TwiML解释器行为。