内容批量发送接口(推荐)

说明

  • 请求前请将发送ip配置到商户白名单
  • 内容必须能匹配已审核的短信模板,传入已审核的签名
  • 可支持多个手机号发送相同内容
  • 商户订单号作为商户自身标识,可由商户自定义,多次传入相同订单号,不保持幂等返回,即同一笔订单商户订单号相同,会生成多个订单下发。

HTTP头信息

参数 内容
Accept application/json;charset=utf-8;
Content-Type application/json;charset=utf-8;
merchantId {对应商户id}
sign {签名,生成方式详见开发引导-接口验签部分}

请求

URL: https://api.moziapi.com/sms/send/batch_content

请求方式: POST

请求参数

参数 类型 最大长度 是否必填 说明
merchantOrderId string 64 商户订单号,接入可自定义,选填。
sign string 已审核短信签名,无需添加【】符号。发送短信时会自动加上。例:XX技术
itemList array 100 手机号和内容数组一次最多 100 个记录
itemList[n].mobile string 暂不支持国际号码,支持 11 位手 机号
itemList[n].content string 短信内容, 须匹配相应已审核模 板,无需增加签名部分 例:尊敬 的用户,您已经申请通过!

json请求参数示例

{
    "merchantOrderId":"32678131321431",
    "sign":"XX技术",
    "content":"尊敬的用户,您已经申请通过!",
    "itemList":[
      {"mobile":"132xxx0159","content":"尊敬的用户,您已经申请通过! "},
      {"mobile":"139xxxx5227","content":"尊敬的用户,您已经申请通过!"}
    ]
}

响应结果

参数 类型 最大长度 是否必填 说明
merchantOrderId string 64 商户提交的订单号
status int 1 响应状态:1:成功;0:失败
code string 4 响应错误码
msg string 128 响应错误信息
result resultObj[] 100 发送单/多个手机号结果
resultObj.mobile string 11 手机号码
resultObj.code string 7 标识码 B000000-发送成功 其余请参照错误码表
resultObj.msg string 128 状态描述
resultObj.orderId int 20 平台订单号

json返回正确参数示例

{
    "merchantOrderId": "32678131321431",
    "status":1,
    "result": [
        {
            "mobile": "1529000xxxx",
            "code": "B000000",
            "msg": "成功",
            "orderId": 298451059435671552
        },
        {
            "mobile": "136972xxxx",
            "code": "B000000",
            "msg": "成功",
            "orderId": 298451059444060160
        }
    ]
}

json返回错误参数示例

{
    "merchantOrderId": "32678131321431",
    "status": 0,
    "code": "B100001",
    "msg": "白名单校验未通过"
}

results matching ""

    No results matching ""