海地短信API：向+509号码群发短信

海地与多米尼加共和国共享伊斯帕尼奥拉岛，首都和最大城市为太子港，有大量海外社区汇款回国。银行、医疗机构和快递服务等组织使用短信与用户沟通。短信由支付确认、预约提醒和包裹跟踪更新等事件触发。选择短信是因为它能覆盖所有人，包括在Cap-Haïtien或Jacmel等互联网接入有限的农村地区的人们。

获取API密钥海地专属需求

海地

国际区号 +509

每条短信分段: $0.01637
$100可发送短信数: 6,108
本地语言: 法语
编码: GSM-7或Unicode

向海地发送群发短信的费用

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

消息	1个分段	2个分段
1	$0.01637	$0.03274
1,000	$16.37	$32.74
10,000	$163.70	$327.40
100,000	$1,637.00	$3,274.00

海地的号码格式

海地的手机号码在+509后有8位数字，没有区号前缀，因此本地格式34 10 1234在to字段中变为+509 34 10 1234。

字母和分段

法语文本每段可容纳160个GSM-7字符，但若包含â、ê、î、ô、û、ç、ë或ï等字符时，会转为Unicode编码（每段70字符，每部分67字符）。短提醒应避免使用这些字符以保持单段；长文本时控制台会标注导致编码转换的特定字符。

时区和时间

海地会调整时钟：太子港在1月为UTC-5，7月为UTC-4。太子港的09:00在1月为UTC的14:00，夏令时期间则提前一小时，因此send_at应使用本地偏移量（例如冬季为-05:00），API会进行转换。

通过一个请求向海地发送

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

import json, os, urllib.request

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