若申请的资质用途为他用或申请的签名涉及第三方权益,则必须获取第三方授权,并在申请前提前创建授权委托书。
接口说明
- 请您在使用前阅读授权书规范,下载授权委托书模板后,根据规范完成填写并盖章后上传。
- 您创建的授权委托书可在后续申请短信资质/申请短信签名时使用,如果您的资质/签名涉及他用,则必须创建授权委托书并提交。
- 创建授权委托书后,您可以通过 QuerySmsAuthorizationLetter 查询已创建的授权书详情;通过接口创建的授权书信息会同步在短信服务控制台。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
AuthorizationLetterPic | string | 是 | 上传到 OSS 的授权委托书文件信息。请下载授权委托书模板后,根据规范完成填写并盖章后上传。文件上传要求:
| cainiao1.png |
SignList | array | 是 | 委托授权签名列表,签名数量不超过 100 个。 说明
建议您在授权书内将可能需要用到的签名一次性全部授权,避免后续申请签名时不在授权书签名范围内,导致审核不通过且需重新补充委托授权书。
| |
string | 是 | 短信签名名称,请遵守签名规范。长度限 2~12 字符,不支持包含“测试”、“test”等字样;不支持添加【】、()、[]等符号;不支持 | 菜鸟网络 | |
AuthorizationLetterExpDate | string | 是 | 授权委托书有效期。有效期格式: 说明
有效期限建议为 1~3 年。请设定一个合理的时间周期,避免有效期过长或过短。
| 2023-01-01~2026-01-01 |
Authorization | string | 是 | 委托授权方,即签名归属方。符号仅支持中点 | 菜鸟网络科技有限公司 |
OrganizationCode | string | 是 | 委托授权方社会统一信用代码,长度不超过 150 字符。信用代码必须与签名绑定的资质信息中社会统一信用代码字段保持一致,否则创建签名失败。 | 9****************A |
ProxyAuthorization | string | 是 | 被委托授权方,即签名申请方。符号仅支持中点 | 支付宝(中国)网络技术有限公司 |
AuthorizationLetterName | string | 是 | 授权委托书命名。命名不可与您其他授权书重复,仅支持中文、英文或与数字组合,不可含符号或纯数字,长度不超过 100 字符。 | 菜鸟公司授权书 |
返回参数
示例
正常返回示例
JSON
格式
{
"AccessDeniedDetail": "无",
"RequestId": "F655A8D5-B967-440B-8683-DAD6FF8DE990\n",
"Message": "OK",
"Data": "10000****",
"Code": "OK",
"Success": true
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | AuthorizationLetterNameRepeat | The authorization letter name is duplicated. | 委托授权书命名重复 |
400 | AuthorizationLetterDateNotMatchRegex | The format of the authorization letter's effective and expiry date is incorrect. | 委托授权书生失效时间格式错误 |
400 | AuthorizationLetterDateNotValid | The current time is not within the validity period of the authorization letter. | 当前时间不在委托授权书有效期范围内 |
400 | AuthorizationLetterNameNotMatchRegex | The authorization letter name cannot be empty and must consist of Chinese, English characters or a combination with numbers, symbols or purely numeric input are not supported. | 委托授权书命名非空且支持中文、英文或与数字组合进行命名,暂不支持任何符号或纯数字输入 |
400 | AuthorizationLetterNameOverLimit | The authorization letter name exceeds the 100-character length limit. | 委托授权书命名超出100个字符长度限制 |
400 | AuthorizationNotMatchRegex | The authorizer name cannot be empty and currently does not support any symbols except middle dots, spaces, Chinese brackets, and English parentheses or purely numeric input. | 授权方命名非空且暂不支持包含除中点(·)、空格、中文括号【】、英文括号()外的任何符号或纯数字输入 |
400 | AuthorizationOssFileNotUploadError | The authorization letter file has not been uploaded. | 委托授权书文件未上传 |
400 | AuthorizationOverLimit | The authorizer exceeds the 1000-character length limit. | 授权方超出1000个字符长度限制 |
400 | ProxyAuthorizationOverLimit | The authorized party exceeds the 1000-character length limit. | 被授权方超出1000个字符长度限制 |
400 | ProxyAuthorizationNotMatchRegex | The authorized party name currently does not support any symbols except middle dots, spaces, Chinese brackets, and English parentheses or purely numeric input. | 被授权方命名暂不支持包含除中点(·)、空格、中文括号【】、英文括号()外的任何符号或纯数字输入 |
400 | SignNumOverLimit | The signature exceeds the limit of 100 entries. | 签名超过100个数量限制 |
400 | SignNotMatchRegex | The signature length is limited to 2-12 characters and does not support some special characters. | 签名长度限2-12个字符,不支持包含“测试”“test”【】[] 、,。括号和空格等特殊字符 |
400 | OrganizationCodeOverLimit | The organization code is limited to 150 characters. | 统一社会信用代码不允许超过150个字符 |
访问错误中心查看更多错误码。