科索沃的 SMS API：群發簡訊至 +383 號碼

科索沃位於巴爾幹半島，首府普里什蒂納，以快速發展的科技產業和僑匯經濟聞名。發送簡訊的軟體產品包括銀行、電商平台、政府服務和當地企業。觸發簡訊的情境包含付款通知、配送更新、預約提醒和公共公告。開發者選擇簡訊是因為它能觸及所有行動用戶，包含使用基本功能手機的鄉村地區和使用智慧型手機的都市居民。

取得 API 金鑰科索沃的請求

科索沃

國碼 +383

每段簡訊: $0.00847
$100 可發送的簡訊數量: 11,806
本地語言: 阿爾巴尼亞語
編碼: GSM-7 或 Unicode

發送至科索沃的群發簡訊費用

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

訊息	1 個分段	2 個分段
1	$0.00847	$0.01694
1,000	$8.47	$16.94
10,000	$84.70	$169.40
100,000	$847.00	$1,694.00

科索沃的號碼格式

科索沃行動電話號碼在+383後有8位數字。當地寫法會加上前導0 (043 201 234)；在API中需省略這個0，因此相同號碼在to欄位應輸入為+383 43 201 234。

字元集與分段

阿爾巴尼亞語簡訊在未使用 ë 和 ç 字母時，每分段可容納 160 個 GSM-7 字元；這些字母超出 GSM-7 範圍會使訊息轉為 Unicode 編碼，每分段僅 70 字元（每部分 67 字元）。簡短通知可避免使用這些字母以維持單一分段；較長內容則由控制台標示導致編碼變更的字母。

時區與發送時間

科索沃實施日光節約時間：普里什蒂納1月為UTC+1，7月為UTC+2。普里什蒂納時間09:00在1月是UTC時間08:00，夏令時間期間會再提前一小時。請在send_at提供當地時區偏移值(例如冬季+01:00)，API會自動轉換。

單一請求發送至科索沃

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

import json, os, urllib.request

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