发送不同内容短信

最近更新时间:2020-07-31 14:28:28

发送不同内容短信(SendDiffSms)

描述

给多个手机号发送不同内容的短信,仅支持国内手机号

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

公共参数列表 详情

名称 类型 必须 长度限制 参数格式 描述 备注
Action String 确定值 [a-zA-Z]+ 操作接口名,系统规定参数,取值:SendDiffSms
Version String 确定值 版本号,系统规定参数,取值:2019-05-01
SignName String 中文,不含特殊符号【】 签名名称 签名需要联系客服提前报备
TplId String [0-9]+ 模板ID
SmsType Int 类型值:1验证码, 2 通知 ,3营销类短信 需单独联系客服开通免模板权限,开通后该参数必填(TplId, TplParams不能传值)
SmsList json(SmsList[]) 下行短信列表 上限100个 手机号+内容
ExtId String 最多50个字符 [0-9a-zA-Z]+ 客户自定义流水号
ExtNo String [0-9]+ 自定义扩展号 需单独联系客服开通
SmsList 定义
名称 类型 必须 长度限制 参数格式 描述 备注
Mobile String [0-9,]+ 手机号: 国内 11位数字,例如 1xxxxxxxx 只允许单个手机号
TplParams Array { "模板变量": "模板变量值" } 例如模板如下:你的验证码{code},有效期为五分钟。其中code是模块变量,则TplParams参数值格式为:{"code":123456},如果你的模板是营销模板,没有变量,则该参数值为: {}
Content String 最多500个字符 中英文字符,不含特殊符号【】 短信内容 需单独联系客服开通免模板权限,开通后该参数必填(TplId, TplParams不能传值)
返回结果

通过指定 Accept:application/json,返回的数据格式为json

名称 类型 描述 备注
ExtId String 客户自定义的流水号
RequestId String 请求唯一标识
SmsList SmsList[] 短信返回值列表,与请求时的个数一致,当返回响应出现异常时不包含此字段
SmsList定义
名称 类型 描述 备注
Mobile String 手机号
Sid String 短信ID
示例(调用成功)
请求示例
curl -X POST \
  'http://ksms.api.ksyun.com/' \
  -H 'accept: application/json' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'host: ksms.api.ksyun.com' \
  -d 'Action=SendDiffSms&Version=2019-05-01&Signature=xxxx&SignatureVersion=1.0&Timestamp=2019-08-13T17:18:36Z&Service=ksms&Accesskey=xxx&SignName=xxx&SmsType=1&SmsList=xxx'
响应成功返回示例
{
    "SmsList": [
        {
            "Sid": "004b9c42b81592810649",
            "Mobile": "1****2"
        },
        {
            "Sid": "014b9c42b81592810649",
            "Mobile": "1****1"
        }
    ],
    "ExtId": "",
    "RequestId": "a742c7b2-5a8a-4d34-b488-2ec6d4e972e8"
}
响应失败返回示例
{
    "RequestId": "ED9B3DF4-75AF-4573-8DD4-7611C57292F2",
    "Error": {
        "Type": "sender",
        "Message": "Invalid sign name",
        "Code": "InvalidSignName"
    }
}

访问API错误码查看更多错误码

金山云,开启您的云计算之旅

免费注册