科索沃的SMS API：群發短信至+383號碼

科索沃位於巴爾幹半島，首都為普里什蒂納，以其不斷增長的科技行業和匯款驅動的經濟而聞名。發送 SMS 的軟件產品包括銀行、電子商務平台、政府服務和本地企業。訊息由付款通知、送貨更新、預約提醒和公共公告觸發。開發人員選擇 SMS 是因為它能觸及所有手機用戶，包括使用基本手機的農村地區居民和使用智能手機的城市居民。

獲取 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 個）。對於簡短提醒，請避免使用這些字母以保持一個分段；對於較長的文本，控制台會標出每個改變編碼的字母。

時區與發送時間

科索沃會更改時鐘：普里什蒂納在一月份使用 UTC+1，七月份使用 UTC+2。普里什蒂納的 09:00 在一月份是 UTC 的 08:00，而在夏令時間運行時會比 UTC 早一小時，因此請使用當地偏移量（例如冬季的 +01:00）提供 send_at，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"