科索沃短信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，夏令时期间会再提前1小时。因此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"