创建短信任务

创建短信发送任务。templateId 必须大于 0，mobileList 不能为空且去重后不超过 20 条，手机号需符合格式。短信服务需已注册并开启，模板需存在。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
templateId	int64	是	短信模板 ID，必须大于 0	1001
mobileList	string[]	是	目标手机号列表，去重后不超过 20 个	["13800138000","13900139000"]
params	string[]	否	模板参数列表，顺序对应模板中的占位符	["验证码1234"]

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	string	任务 ID 字符串	123456

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求体为空或 JSON 格式错误
14500	服务内部异常
67406	参数缺失：templateId/mobileList 为空或模板不存在
67407	短信服务未开启或未注册
67408	手机号数量超过 20 条限制
67501	手机号格式错误
67502	模板参数长度超限

postEndpoint

/openapi/smstask/create

curl -X POST "https://qiyukf.com/openapi/smstask/create?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "templateId": 1001,    "mobileList": [      "13800138000",      "13900139000"    ]  }'

{
  "code": 200,
  "message": "123456"
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求体为空或 JSON 格式错误"
}

{
  "code": 14500,
  "message": "服务内部异常"
}

{
  "code": 67406,
  "message": "参数缺失：templateId/mobileList 为空或模板不存在"
}

{
  "code": 67407,
  "message": "短信服务未开启或未注册"
}

{
  "code": 67408,
  "message": "手机号数量超过 20 条限制"
}

{
  "code": 67501,
  "message": "手机号格式错误"
}

{
  "code": 67502,
  "message": "模板参数长度超限"
}