利比亞的SMS API：群發短信至+218號碼

利比亞位於北非，首都係的黎波里，以石油工業同不斷發展嘅數碼服務聞名。銀行、電子商務平台同醫療保健供應商經常向用戶發送短訊。短訊由付款確認、預約提醒或服務更新等事件觸發。選擇 SMS 係因為佢可以到達所有流動設備，無需互聯網，而且廣受信任用於重要通知。

獲取 API 金鑰利比亞的請求

利比亞

電話區號 +218

每條短信分段: $0.02697
$100的短信: 3,707
當地語言: 阿拉伯文
編碼: Unicode (UCS-2)

發送至利比亞的群發簡訊費用

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

訊息	1 分段	2 分段
1	$0.02697	$0.05394
1,000	$26.97	$53.94
10,000	$269.70	$539.40
100,000	$2,697.00	$5,394.00

利比亞的電話號碼格式

利比亞嘅流動電話號碼喺 +218 之後有 9 位數字。當地寫法會喺前面加 0 (091-2345678)；喺 API 中會省略呢個 0，所以相同號碼喺 to 欄位中應輸入為 +218 91 2345678。

字母與分段

阿拉伯文嘅短訊始終使用 Unicode，所以發往利比亞嘅阿拉伯文短訊每段有 70 個字符，較長短訊嘅每一部分則有 67 個字符。用英文或普通拉丁字母編寫嘅代碼同警報可容納 160 個字符，從而將長通知嘅成本減半。

時區與發送時間

利比亞全年採用 UTC+2 時間，沒有夏令時，因此的黎波里的 09:00 永遠是 UTC 07:00。send_at 接受 UTC 或任何 ISO 8601 偏移時間，而控制台排程器會根據你的時區進行轉換。

單一請求發送至利比亞

系統將立即返回包含訊息ID、號碼所屬國家(LY)及價格的回應。送達或失敗事件將通過您的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": "+218912345678", "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: "+218912345678", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.02697", country: "LY"

import json, os, urllib.request

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