短信 · 短信 API
短信 API：从您的软件一次请求即可发送短信。
通过您的 CRM、ERP、电商系统或自己的应用发送短信、查询送达状态、接收上行消息和退订通知。REST 与 JSON；身份验证使用 Bearer 密钥，事件通过 HMAC 签名的 Webhook 推送。
# 个性化批量短信
curl -X POST https://api.buluthat.com/api/sms.php?action=send \ -H "Authorization: Bearer bt_xxx" -H "Content-Type: application/json" \ -d '{"header":"FIRMAADI","message":"Merhaba {ad}, siparişiniz kargoda.", "recipients":[{"phone":"05321234567","name":"Ayşe"}]}'
# 响应
{"ok":true,"data":{"campaign_id":152,"status":"queued","recipients":1,"credits":1}}
# 送达事件（Webhook，HMAC 签名）
X-Buluthat-Event: sms.delivery {"event":"delivery","data":{"campaign_id":152,"status":"delivered"}}
有哪些内容
功能
一次请求即可发送
send 操作：单个号码、名单或个性化的不同文本；占位符由收件人字段填充。
送达报告
通过 status，可按发送编号或您自己的引用编号 (custom_ref) 查询每条消息的状态。
带签名的 Webhook
送达、上行短信和退订事件使用 X-Buluthat-Signature (HMAC-SHA256) 签名后发送到您的地址；失败时会退避重试。
额度与标题查询
通过 balance 获取剩余短信/OTP 额度和到期日期，通过 headers 获取您已获批的标题。
定时发送与取消
通过 send_at 可预约至最多 90 天后；通过 cancel 可取消未发送的消息，额度退还。
黑名单
通过 blacklist_add / blacklist_remove 同步您自己的退订名单。
OTP 接口
通过 otp_send、otp_verify 和 otp_status 管理验证码，无需另建表。
İYS 与速率设置
通过 is_commercial，商业信息会经过 İYS 校验；通过 rate_per_minute，您可限制每分钟的发送量。
常见问题
关于短信 API
在开发者栏目的短信 API 页面中；附有示例请求、响应和错误码。
您在面板的批量短信 > API 与设置界面中创建；Webhook 地址也在同一界面填写。
同一请求中重复的号码只发送一次；若开启重复保护，同一天同一内容不会再次发给同一号码。
SMS
携手更强
批量短信、验证码、上行短信和 API——使用您已获批的标题。