吉爾吉斯的SMS API：群發短信至+996號碼

吉爾吉斯斯坦是中亞的一個山區國家，首都為比什凱克，其經濟依賴於金礦開採、農業、貿易和海外工人寄回家的錢。銀行應用程式、送貨服務和旅行社等軟件產品向用戶發送短信。這些訊息由帳戶更新、送貨確認或預訂變更等事件觸發。SMS被選擇是因為它能觸及每部手機，無需互聯網即可工作，並且閱讀速度快，使其對城市和農村用戶都可靠。

獲取 API 金鑰吉爾吉斯的請求

吉爾吉斯

電話區號 +996

每條短信分段: $0.05107
$100的短信: 1,958
當地語言: 吉爾吉斯語和俄語
編碼: Unicode (UCS-2)

發送至吉爾吉斯的群發簡訊費用

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

訊息	1 分段	2 分段
1	$0.05107	$0.10214
1,000	$51.07	$102.14
10,000	$510.70	$1,021.40
100,000	$5,107.00	$10,214.00

吉爾吉斯的電話號碼格式

吉爾吉斯斯坦的手機號碼在+996後有9位數字。在本地，它們以0開頭（0700 123 456）；在API中，該0被省略，因此相同的號碼在to字段中輸入為+996 700 123 456。

字母與分段

西里爾字母文本始終是Unicode，因此發往吉爾吉斯斯坦的吉爾吉斯語訊息每段承載70個字符，較長訊息的每部分承載67個字符。用英語或純拉丁字母編寫的代碼和警報則適合160個字符，這使得長通知的成本減半。

時區與發送時間

吉爾吉斯斯坦全年保持UTC+6，不調整時鐘，因此比什凱克的09:00始終為03:00 UTC。send_at接受UTC或任何ISO 8601偏移量，控制台調度程序會從您的時區進行轉換。

單一請求發送至吉爾吉斯

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

import json, os, urllib.request

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