聖馬利諾的 SMS API：群發簡訊至 +378 號碼

聖馬利諾是被義大利包圍的歐洲微型國家，以旅遊業與金融服務聞名。飯店、銀行、政府機構與文化組織等企業會發送SMS，內容包含預訂確認、付款更新、活動提醒與公共公告。因SMS簡潔可靠，能快速送達居民與遊客，故為首選通訊方式。

聖馬利諾

國碼 +378

每段簡訊: $0.00987
$100 可發送的簡訊數量: 10,131
本地語言: 義大利文
編碼: GSM-7

發送至聖馬利諾的群發簡訊費用

每則簡訊至聖馬利諾的價格為每分段$0.00987。超過160個GSM-7字元或70個Unicode字元的內容會被分割，因此兩分段的簡訊費用將加倍。

訊息	1 個分段	2 個分段
1	$0.00987	$0.01974
1,000	$9.87	$19.74
10,000	$98.70	$197.40
100,000	$987.00	$1,974.00

聖馬利諾的號碼格式

聖馬利諾手機號碼為+378後接8位數字（無冠碼），故當地格式66 66 12 12在to欄位應輸入為+378 66 66 12 12。

字元集與分段

義大利文字符合 GSM-7 字元集，因此發送到聖馬利諾的簡訊每段可容納 160 個字元，較長簡訊的每一部分則為 153 個字元。請注意從其他工具複製的彎引號和表情符號：其中任何一個都會將整段文字轉為 Unicode，每段僅能容納 70 個字元，而 POST /v1/estimates 會在發送前顯示編碼方式。

時區與發送時間

聖馬利諾會調整時鐘：一月為 UTC+1，七月為 UTC+2。聖馬利諾的 09:00 在一月是 UTC 08:00，夏令時間期間則比 UTC 早一小時，因此請在 send_at 中提供當地偏移量（例如冬季的 +01:00），API 會進行轉換。

單一請求發送至聖馬利諾

系統將立即回覆包含訊息ID、號碼所屬國家(SM)及價格。後續將透過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": "+37866661212", "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: "+37866661212", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.00987", country: "SM"

import json, os, urllib.request

req = urllib.request.Request(
    "https://bulksmsapi.cc/v1/messages",
    data=json.dumps({"to": "+37866661212", "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.00987"