发送不同内容短信

发送不同内容短信（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个 手机号+内容，示例："[{“TplParams”:{“code”:“111111”},“Mobile”:“1xxxxxxxxxx”},{“TplParams”:{“code”:“2222222”},“Mobile”:“1xxxxxxxxxx”}]"
ExtId	String	否	最多256个字符		客户自定义流水号
ExtNo	String	否		[0-9]+	自定义扩展号	需单独联系客服开通

SmsList 定义

名称	类型	必须	长度限制	参数格式	描述	备注
Mobile	String	是		[0-9,]+	手机号: 国内 11位数字，例如 1xxxxxxxxxx	只允许单个手机号
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.ksyun.com/' \
  -H 'accept: application/json' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'host: ksms.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": "1xxxxxxxxxx"
        },
        {
            "Sid": "014b9c42b81592810649",
            "Mobile": "1xxxxxxxxxx"
        }
    ],
    "ExtId": "",
    "RequestId": "a742c7b2-5a8a-4d34-b488-2ec6d4e972e8"
}

响应失败返回示例

{
    "RequestId": "ED9B3DF4-75AF-4573-8DD4-7611C57292F2",
    "Error": {
        "Type": "sender",
        "Message": "Invalid sign name",
        "Code": "InvalidSignName"
    }
}

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