梵蒂冈短信API：向+39号码群发短信

梵蒂冈城是世界上最小的独立国家，位于罗马市内，是天主教会的灵性中心。活动管理系统、朝圣应用和行政服务等软件产品会向游客和工作人员发送短信。这些短信由游览确认、日程变更和安全警报等事件触发。选择短信是因为它能即时覆盖所有手机，包括国际游客的手机。

获取API密钥梵蒂冈专属需求

梵蒂冈

国际区号 +39

每条短信分段: $0.00987
$100可发送短信数: 10,131
本地语言: 意大利语
编码: GSM-7

向梵蒂冈发送群发短信的费用

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

消息	1个分段	2个分段
1	$0.00987	$0.01974
1,000	$9.87	$19.74
10,000	$98.70	$197.40
100,000	$987.00	$1,974.00

梵蒂冈的号码格式

梵蒂冈城的电话号码使用意大利编号计划，因此它们以+39 06 698开头，并按意大利费率计费。发送时使用+39后跟完整号码，就像您以国际格式书写任何意大利号码一样。

字母和分段

意大利语文本保持在GSM-7字母表内，因此发送到梵蒂冈城的一段短信可容纳160个字符，较长文本的每部分为153个字符。注意从其他工具复制的花引号和表情符号：其中一个会将整个文本转换为Unicode，每段70个字符，POST /v1/estimates会在发送前显示编码。

时区和时间

梵蒂冈城会调整时钟：梵蒂冈在1月为UTC+1，7月为UTC+2。梵蒂冈的09:00在1月是UTC的08:00，在夏令时期间则比UTC早一小时，因此send_at应使用本地偏移量（例如冬季的+01:00），API会进行转换。

通过一个请求向梵蒂冈发送

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

import json, os, urllib.request

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