调用GetSmsAuthTokens接口获取短信验证码授权Token。
接口说明
准备工作
请先完成阿里云账号注册、获取阿里云访问密钥、创建认证方案等操作,更多信息,请参见短信认证使用流程。
QPS限制
本接口的单用户QPS限制为5000次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
PackageName | string | 否 | 包名。OsType为Android时必传。 | com.aliqin.mytel.test |
SignName | string | 否 | 签名。OsType为Android时必传。 | 47fcc6615485e83b4100433**** |
SceneCode | string | 是 | 方案号。 | FC100000134840112 |
OsType | string | 是 | 系统类型。取值:Android或iOS。 | Android |
BundleId | string | 否 | iOS应用ID。OsType为iOS时必传。 | 12345**** |
Expire | long | 是 | Token有效期(单位:秒),最小900,最大43200。 | 900 |
SmsTemplateCode | string | 是 | 短信模板Code。 | SMS_13987**** |
SmsCodeExpire | integer | 否 | 短信验证码有效期(单位:秒),默认180。 | 60 |
返回参数
示例
正常返回示例
JSON
格式
{
"Code": "OK",
"Message": "请求成功",
"RequestId": "8906582E-6722",
"Data": {
"BizToken": "FZSMeRbLCiapIBo65NXNHvGbkGDmhs23XWTZDOtZN0g5n/kqSc2FU27Gc9YhGb6dNn9/L9ZXSYiIB6C6LMLQJjyXjRzt5v6pzZXqnjO4cSuPWYUxJvdc8l8OpucEYe8Mx17HxsHDzj0VC4D5+atcrTpJE6jQ7e2QVNjZIPMwsfxELjQS7c****",
"StsAccessKeySecret": "VboZ4xbZ****",
"StsAccessKeyId": "STS.NSqC****",
"ExpireTime": 1631526326000,
"StsToken": "CAISiQJ1q6Ft5B2yfSjIr5DEDP/BurtW9PemMEfBrEpsOr5K17XjuDz2IHtLfXFsBusYt/U2nWpX5v4clrxIToR7SFbFY9pb6ZhazBisebDGv8HtR3TcFEjiSwapEBfe8JL4QYeQFaHwGJqEb1TDiVUAo9/TfimjWFqIKICAjYUdAP0cQgi/a0gtZr4UXHwAzvUXLnzML/2gHwf3i27LdipStxF7lHl05NbUoKTeyGKH3AGqlLVF9tite8f9NpczBvolDYfpht4RX7HazStd5yJN8KpLl6Fe8V/FxIrGXAAJv0rdbbOFq4Q1c18hOLJHAKtfsvXmlPNpsevfmpnsx****"
}
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | SmsSignNameNotExist | The specified sms signName is invalid. | 短信签名不存在 |
访问错误中心查看更多错误码。
Java SDK
您可以通过添加Maven依赖安装阿里云Java SDK。SDK版本会持续更新,具体版本请以OpenAPI页面为准。
JAVA SDK MAVEN坐标
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>dypnsapi20170525</artifactId>
<version>1.0.6</version>
</dependency>