CreateSmsAuthorizationLetter - 创建授权委托书

若申请的资质用途为他用或申请的签名涉及第三方权益,则必须获取第三方授权,并在申请前提前创建授权委托书。

接口说明

  • 请您在使用前阅读授权书规范,下载授权委托书模板后,根据规范完成填写并盖章后上传。
  • 您创建的授权委托书可在后续申请短信资质/申请短信签名时使用,如果您的资质/签名涉及他用,则必须创建授权委托书并提交。
  • 创建授权委托书后,您可以通过 QuerySmsAuthorizationLetter 查询已创建的授权书详情;通过接口创建的授权书信息会同步在短信服务控制台。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
AuthorizationLetterPicstring

上传到 OSS 的授权委托书文件信息。请下载授权委托书模板后,根据规范完成填写并盖章后上传。文件上传要求:

  • 待上传的文件命名不可包含中文和特殊字符。
  • 仅支持 jpg、png、gif、jpeg 格式的图片,图片不大于 5MB,上传操作请参见通过 OSS 上传文件
cainiao1.png
SignListarray

委托授权签名列表,签名数量不超过 100 个。

说明 建议您在授权书内将可能需要用到的签名一次性全部授权,避免后续申请签名时不在授权书签名范围内,导致审核不通过且需重新补充委托授权书。
string

短信签名名称,请遵守签名规范。长度限 2~12 字符,不支持包含“测试”、“test”等字样;不支持添加【】、()、[]等符号;不支持、,。空格等特殊字符。

菜鸟网络
AuthorizationLetterExpDatestring

授权委托书有效期。有效期格式:YYYY-MM-DD~YYYY-MM-DD

说明 有效期限建议为 1~3 年。请设定一个合理的时间周期,避免有效期过长或过短。
2023-01-01~2026-01-01
Authorizationstring

委托授权方,即签名归属方。符号仅支持中点·、中文【】()、英文()及空格,不可含其他符号或纯数字,长度不超过 150 字符。

菜鸟网络科技有限公司
OrganizationCodestring

委托授权方社会统一信用代码,长度不超过 150 字符。信用代码必须与签名绑定的资质信息中社会统一信用代码字段保持一致,否则创建签名失败。

9****************A
ProxyAuthorizationstring

被委托授权方,即签名申请方。符号仅支持中点·、中文【】()、英文()及空格,不可含其他符号或纯数字,长度不超过 150 字符。

支付宝(中国)网络技术有限公司
AuthorizationLetterNamestring

授权委托书命名。命名不可与您其他授权书重复,仅支持中文、英文或与数字组合,不可含符号或纯数字,长度不超过 100 字符。

菜鸟公司授权书

返回参数

名称类型描述示例值
object
AccessDeniedDetailstring

访问被拒绝详细信息,只有 RAM 校验失败才会返回此字段。

RequestIdstring

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

F655A8D5-B967-440B-8683-DAD6FF8DE990
Messagestring

状态码的描述。

OK
Datastring

委托授权书 ID。

10000****
Codestring

请求状态码。

  • 返回 OK 代表请求成功。
  • 其他错误码,请参见本章节的错误码列表或产品API 错误码
OK
Successboolean

调用接口是否成功。取值:

  • true:调用成功。
  • false:调用失败。
true

示例

正常返回示例

JSON格式

{
  "AccessDeniedDetail": "无",
  "RequestId": "F655A8D5-B967-440B-8683-DAD6FF8DE990\n",
  "Message": "OK",
  "Data": "10000****",
  "Code": "OK",
  "Success": true
}

错误码

HTTP status code错误码错误信息描述
400AuthorizationLetterNameRepeatThe authorization letter name is duplicated.委托授权书命名重复
400AuthorizationLetterDateNotMatchRegexThe format of the authorization letter's effective and expiry date is incorrect.委托授权书生失效时间格式错误
400AuthorizationLetterDateNotValidThe current time is not within the validity period of the authorization letter.当前时间不在委托授权书有效期范围内
400AuthorizationLetterNameNotMatchRegexThe 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.委托授权书命名非空且支持中文、英文或与数字组合进行命名,暂不支持任何符号或纯数字输入
400AuthorizationLetterNameOverLimitThe authorization letter name exceeds the 100-character length limit.委托授权书命名超出100个字符长度限制
400AuthorizationNotMatchRegexThe 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.授权方命名非空且暂不支持包含除中点(·)、空格、中文括号【】、英文括号()外的任何符号或纯数字输入
400AuthorizationOssFileNotUploadErrorThe authorization letter file has not been uploaded.委托授权书文件未上传
400AuthorizationOverLimitThe authorizer exceeds the 1000-character length limit.授权方超出1000个字符长度限制
400ProxyAuthorizationOverLimitThe authorized party exceeds the 1000-character length limit.被授权方超出1000个字符长度限制
400ProxyAuthorizationNotMatchRegexThe authorized party name currently does not support any symbols except middle dots, spaces, Chinese brackets, and English parentheses or purely numeric input.被授权方命名暂不支持包含除中点(·)、空格、中文括号【】、英文括号()外的任何符号或纯数字输入
400SignNumOverLimitThe signature exceeds the limit of 100 entries.签名超过100个数量限制
400SignNotMatchRegexThe signature length is limited to 2-12 characters and does not support some special characters.签名长度限2-12个字符,不支持包含“测试”“test”【】[] 、,。括号和空格等特殊字符
400OrganizationCodeOverLimitThe organization code is limited to 150 characters.统一社会信用代码不允许超过150个字符

访问错误中心查看更多错误码。