CreateSmsAuthorizationLetter - 创建授权委托书

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

接口说明

  • 请您在使用前阅读授权书规范,下载授权委托书模板后,根据规范完成填写并盖章后上传。

  • 您创建的授权委托书可在后续申请短信资质/申请短信签名时使用,如果您的资质/签名涉及他用,则必须创建授权委托书并提交。

  • 创建授权委托书后,您可以通过 QuerySmsAuthorizationLetter 查询已创建的授权书详情;通过接口创建的授权书信息会同步在短信服务控制台。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

AuthorizationLetterPic

string

委托授权书的 fileKey。

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

  • 待上传的文件命名不可包含中文和特殊字符。

  • 仅支持 jpg、png、gif、jpeg 格式的图片,图片不大于 5MB。

  1. fileKey 的获取方式如下:通过 OSS 上传文件

123456/test1719383196031.jpg

SignList

array

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

说明

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

string

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

菜鸟网络

AuthorizationLetterExpDate

string

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

说明

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

2023-01-01~2026-01-01

Authorization

string

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

菜鸟网络科技有限公司

OrganizationCode

string

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

9****************A

ProxyAuthorization

string

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

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

AuthorizationLetterName

string

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

菜鸟公司授权书

返回参数

名称

类型

描述

示例值

object

AccessDeniedDetail

string

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

RequestId

string

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

F655A8D5-B967-440B-8683-DAD6FF8DE990

Message

string

状态码的描述。

OK

Data

string

委托授权书 ID。

10000****

Code

string

请求状态码。

  • 返回 OK 代表请求成功。

  • 其他错误码,请参见本章节的错误码列表或产品API 错误码

OK

Success

boolean

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

  • true:调用成功。

  • false:调用失败。

枚举值:

  • true :

    true

  • false :

    false

true

示例

正常返回示例

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个字符

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

变更历史

更多信息,参考变更详情