牙買加的SMS API：群發短信至+1號碼

牙買加係以京斯敦為首都嘅加勒比海島國，以旅遊業、農業同音樂聞名。銀行、度假村、物流公司同大學嘅開發者會透過系統發送短訊，內容包括酒店預訂確認、銀行交易通知、送貨時間提醒同學費繳交期限提示。選擇SMS因為佢能即時送達所有手機，適合漫遊遊客使用，即使喺鄉村地區亦能快速閱讀。

獲取 API 金鑰牙買加的請求

牙買加

電話區號 +1

每條短信分段: $0.01277
$100的短信: 7,830
當地語言: 英語
編碼: GSM-7

發送至牙買加的群發簡訊費用

每條發往牙買加的訊息按$0.01277每分段收費。超過160個GSM-7字符或70個Unicode字符的內容會分割成多段，因此兩段內容的費用將翻倍。

訊息	1 分段	2 分段
1	$0.01277	$0.02554
1,000	$12.77	$25.54
10,000	$127.70	$255.40
100,000	$1,277.00	$2,554.00

牙買加的電話號碼格式

牙買加使用北美編號計劃：+1，三位數區號加七位數號碼，例如 +1 876 210 1234。API 會讀取區號（此處為 876）以將號碼定價為牙買加而非美國，因此請在列表中保留完整的十一位數字。

字母與分段

英文內容符合GSM-7字符集，每條短訊可容納160個字符，長訊息每部分則為153個。注意從其他工具複製嘅花引號同emoji：任何一個都會令整段文字轉用Unicode編碼（每段70字符），發送前可用POST /v1/estimates檢查編碼方式。

時區與發送時間

牙買加全年使用UTC-5且唔實施夏令時間，當地09:00永遠等於UTC 14:00。send_at接受UTC或任何ISO 8601時區偏移，控制台排程器會從你嘅時區自動轉換。

單一請求發送至牙買加

系統將立即返回包含訊息ID、號碼所屬國家(JM)及價格的回應。送達或失敗事件將通過您的webhook跟進，失敗訊息會自動退款。

如需發送列表，可透過POST /v1/batches向最多10,000個號碼發送相同內容，或在messages中為每個號碼設定個性化內容。

訊息參考批次參考

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+18762101234", "text": "Your Northwind code is 482913. It expires in 10 minutes."}'

const res = await fetch("https://bulksmsapi.cc/v1/messages", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.BULKSMSAPI_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ to: "+18762101234", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.01277", country: "JM"

import json, os, urllib.request

req = urllib.request.Request(
    "https://bulksmsapi.cc/v1/messages",
    data=json.dumps({"to": "+18762101234", "text": "Your Northwind code is 482913. It expires in 10 minutes."}).encode(),
    headers={"Authorization": "Bearer " + os.environ["BULKSMSAPI_KEY"], "Content-Type": "application/json", "User-Agent": "northwind-app/1.0"},
    method="POST",
)
with urllib.request.urlopen(req) as res:
    print(json.load(res)["price"])  # "0.01277"