台灣 SMS API · for developers

簡訊 API,
3 行 code 接完。

REST + SDK (Node / Python / CLI) · 送達率 99.7% · 每月 100 封永久免費 · Webhook + NCC 合規自動 · 15 分鐘從註冊到 production。

Node 18+ SDK Python 3.9+ SDK Webhook HMAC Zero config
send-otp.js · Node.js main
import { Cresclab } from '@cresclab/sms';

const sms = new Cresclab(process.env.CRESCLAB_API_KEY);

// OTP · 秒送達 · 含 NCC 合規檢查
await sms.send({
  to:   '+886912345678',
  body: `【Cresclab】驗證碼 ${otp},5 分鐘內有效`,
  type: 'otp',
});
✓ 200 OK { "id": "sms_abc123", "status": "delivered", "segments": 1, "cost_twd": "0.75", "delivered_at": "2026-04-21T09:41:02Z" }
30-SECOND QUICKSTART

從 signup 到 production · 15 分鐘

註冊帶你 auto-generate test API key、給 curl 範例複製到 terminal。正式 API key 在 dashboard 自己開。

# 1. Install SDK
$npm install @cresclab/sms
+ @cresclab/sms@0.1.0

# 2. Set key (from signup response)
$export CRESCLAB_API_KEY=sk_live_...

# 3. Send
$node -e "import('@cresclab/sms').then(({Cresclab}) => new Cresclab(process.env.CRESCLAB_API_KEY).send({to:'+886912345678',body:'【demo】hi'}).then(console.log))"
{ status: 'delivered', id: 'sms_K8f...', segments: 1, cost_twd: '0.75' }
✓ 手機收到「【demo】hi」 ✓ Logs 頁即時跳新 row ✓ Webhook 打 sms.delivered
SDKs

你的語言應該有

官方維護 · 同一套 REST API 包好 · 每個 release 都 smoke-test。

Node.js

@cresclab/sms

npm install @cresclab/sms
Python

cresclab-sms

pip install cresclab-sms
CLI

@cresclab/cli

npm i -g @cresclab/cli
curl

REST · any language

curl api.cresclab.com/v1/sms
PHP Soon

cresclab/sms

composer require cresclab/sms
Go Soon

cresclab.com/sms

go get cresclab.com/sms
Ruby Soon

cresclab-sms

gem install cresclab-sms
Rust Soon

cresclab_sms

cargo add cresclab-sms
CLI

Terminal 愛好者看這裡

從 CI/CD 腳本送 OTP、debug 時 cresclab tail live-stream、pipe 到 jq 處理。

# Install
$npm install -g @cresclab/cli
$export CRESCLAB_API_KEY=sk_live_...

# Send from CI
$cresclab send +886912345678 "【demo】deploy succeeded 🚀"
✓ delivered sms_K8fQx32Lm 1 seg NT$0.75

# Live-tail all outgoing messages
$cresclab tail
Tailing logs... (Ctrl-C to stop)
09:41:02 delivered +886912...637 【demo】deploy succeeded 🚀
09:41:23 delivered +886912...981 【demo】alert: CPU > 90%

# Metrics for billing reconciliation
$cresclab metrics --days 30 --json | jq '.totals'
{ "total": 4312, "delivered": 4289, "failed": 23, "cost_cents": 323400 }
完整 commands:send · broadcast · logs · tail · balance · metrics · whoami
Features

不是 Twilio 的包裝

台灣在地電信直連 · 中文合規 · 台北 team 4h 回信。

Webhook with retry

送達 / 失敗事件自動 POST 你的 endpoint · HMAC-SHA256 簽章 · 失敗指數退避 3 次 0s → 2s → 8s

NCC 合規自動

URL 白名單、禁用縮網址(bit.ly / reurl.cc...)、詐騙關鍵字、實名簽檔自動插入。ncc_blocked error 告訴你哪裡違規。

Live logs + metrics

Dashboard 每 3s poll 新訊息 · 7 天送達率 / 失敗原因 / 成本 breakdown · GET /sms/metrics?days=30

Rate limit 清楚

新帳號 24h 內 200 則、穩定帳號 1000/hr。超量回 429retry_after。不是黑箱。

Atomic wallet debit

送成功才扣 · 電信商失敗自動 refund · wallet_events 完整 ledger · 對帳 API 查得到每一筆。

中文客服

info@cresclab.com 工作日 4h 內回信 · 有 bug 直接 email source repro · 不是外包 ticket system。

API surface

9 個 endpoint,全 REST

完整欄位說明到 app.html#docs

POST/v1/sms/send送一封
GET/v1/sms/:id查一封
GET/v1/sms/list查 log 列表
GET/v1/sms/metrics統計資料
POST/v1/broadcast1:N 廣播
GET/v1/broadcast廣播列表
GET/v1/wallet/balance餘額
GET/v1/wallet/events交易紀錄
PUT/v1/webhooks設 webhook

Free for developers · 上 production 再付錢

沒有時限、沒有信用卡綁定、沒有 email 騷擾。用到上限再開單。

NT$0/月 · 前 100 封 NT$0.75/則 · 超過後按量 議價 · 月量 > 50k

15 分鐘後你應該
已經送出 第一封 SMS

不信?現在試。不用信用卡、送你 NT$50 credit、失敗 email 我們回 4 小時內。

用 GitHub 開通 → Full API docs