短信服务 API
批量发送短信
专门用于大量号码的内容群发(如会员通知、活动提醒类短信)。单次请求最大支持 10 万个号码。
⚠️ 场景建议:由于批量发送底层通道的流转特性,不建议使用该接口发送验证码等具有高时效性要求的内容。
1. 接口信息
接口地址 (URL)
https://sms-api.luosimao.com/v1/send_batch.[json|xml]请求方式
POST
Content-Type
application/x-www-form-urlencoded鉴权方式
HTTP Basic Auth(用户名固定
api,密码为 API_KEY)2. 请求参数 (Request)
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
mobile_list |
String | 是 | 13761428268,18521513391 | 目标手机号码列表,多个号码使用英文逗号 , 分隔。 |
message |
String | 是 | 提醒:您的账号即将到期,请及时充值【公司名称】 | 短信内容(末尾必须包含签名) |
time |
String | 否 | 2023-04-01 12:30:00 | 定时发送的时间。如果设置,平台会在该时间点触发发送。 定时发送任务可以在发送前 10 分钟在发送历史界面进行取消(仅限提交当天)。 |
3. 返回参数 (Response)
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
error |
Number | 0 | 错误码(0 为成功) |
msg |
String | ok | 错误码文本描述 |
batch_id |
String | 09-B0966DD4-FD28-43C3... | 批量发送任务的批次号 |
4. 响应示例
Response — JSON
{
"error": 0,
"msg": "ok",
"batch_id": "09-B0966DD4-FD28-43C3-94A8-F762B2269B72"
}