乌克兰短信API：向+380号码群发短信

乌克兰是东欧的一个国家，首都为基辅，经济多元化，包括农业、IT和制造业。电子商务平台、快递服务和金融机构使用短信与客户沟通。短信通常由包裹配送更新、支付确认或预约提醒等事件触发。短信被选择是因为它广泛可用，适用于所有设备，并且收件人阅读速度快。

获取API密钥乌克兰专属需求

乌克兰

国际区号 +380

每条短信分段: $0.01467
$100可发送短信数: 6,816
本地语言: 乌克兰语
编码: Unicode (UCS-2)

向乌克兰发送群发短信的费用

每条短信按$0.01467每分段向乌克兰收费。超过160个GSM-7字符或70个Unicode字符的文本会被分段，因此两段文本的费用是两倍。

消息	1个分段	2个分段
1	$0.01467	$0.02934
1,000	$14.67	$29.34
10,000	$146.70	$293.40
100,000	$1,467.00	$2,934.00

乌克兰的号码格式

乌克兰的手机号码在+380后有9位数字。本地格式以0开头（050 123 4567）；在API中，0被省略，因此相同的号码在to字段中为+380 50 123 4567。

字母和分段

西里尔字母文本始终为Unicode，因此用乌克兰语发送到乌克兰的短信每段可容纳70个字符，较长文本的每一部分为67个字符。用英文或纯拉丁字母编写的代码和警报可容纳160个字符，这使长通知的成本减半。

时区和时间

乌克兰跨越多个时区，从基辅的UTC+2到辛菲罗波尔的UTC+3（1月偏移量）。UTC的07:00在1月对应基辅的09:00；对于全国范围的提醒，按地区拆分列表并为每个批次设置自己的send_at。

通过一个请求向乌克兰发送

响应会立即返回消息ID、号码匹配的国家（UA）和价格。送达或失败事件会通过您的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": "+380501234567", "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: "+380501234567", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.01467", country: "UA"

import json, os, urllib.request

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