TX云短xin接口

qiujie117275706

TX云v3签名_POST_发送短xin

  

子程序名	返回值类型	公开	备 注
TX云v3签名_POST_发送短xin	文本型
参数名	类 型	参考	可空	数组	备 注
HashedRequestPayload	文本型				提交数据{'PhoneNumberSet':['+8612345678900'],'SmsSdkAppId':'********','SignName':'****','TemplateId':'***','TemplateParamSet':['****']}
SecretKey	文本型				身份密钥
SecretId	文本型				身份ID

变量名	类 型	静态	数组	备 注
a	加解密对象
CanonicalRequest	文本型
StringToSign	文本型
Algorithm	文本型
RequestTimestamp	文本型
CredentialScope	文本型
HashedCanonicalRequest	文本型
SecretDate	文本型
SecretService	文本型
SecretSigning	文本型
Signature	文本型
Authorization	文本型
SignedHeaders	文本型
API_URL	文本型			,
请求头	文本型
响应文本	文本型

SignedHeaders ＝ “content-type;host;x-tc-action”
API_URL ＝ “sms.tencentcloudapi.com”
' 1.拼接规范请求串
CanonicalRequest ＝ “POST” ＋ 字符 (10) ＋ “/” ＋ 字符 (10) ＋ “” ＋ 字符 (10) ＋ “content-type:application/json” ＋ 字符 (10) ＋ “host:sms.tencentcloudapi.com” ＋ 字符 (10) ＋ “x-tc-action:sendsms” ＋ 字符 (10) ＋ “” ＋ 字符 (10) ＋ SignedHeaders ＋ 字符 (10) ＋ 校验_取sha256 (到字节集 (HashedRequestPayload))
' 2.拼接待签名字符串
Algorithm ＝ “TC3-HMAC-SHA256”
RequestTimestamp ＝ 时间_取现行时间戳 (真)
' RequestTimestamp ＝ “1713234015”
CredentialScope ＝ 时间_格式化 (取现行时间 (), “yyyy-MM-dd”, , 真, ) ＋ “/” ＋ 匹配子域名 (API_URL, 1, 1) ＋ “/tc3_request”
HashedCanonicalRequest ＝ 校验_取sha256 (到字节集 (CanonicalRequest))
StringToSign ＝ Algorithm ＋ 字符 (10) ＋ RequestTimestamp ＋ 字符 (10) ＋ CredentialScope ＋ 字符 (10) ＋ HashedCanonicalRequest
' 3.计算签名
SecretDate ＝ a.取HMAC值 ( #哈希算法_SHA256, 时间_格式化 (取现行时间 (), “yyyy-MM-dd”, , 真, ), “TC3” ＋ SecretKey, )
SecretService ＝ a.取HMAC值 ( #哈希算法_SHA256, 匹配子域名 (API_URL, 1, 1), HEX解码 (SecretDate), )
SecretSigning ＝ a.取HMAC值 ( #哈希算法_SHA256, “tc3_request”, HEX解码 (SecretService), )
Signature ＝ a.取HMAC值 ( #哈希算法_SHA256, StringToSign, HEX解码 (SecretSigning), )
' 4.拼接 Authorization
Authorization ＝ Algorithm ＋ “ ” ＋ “Credential=” ＋ SecretId ＋ “/” ＋ CredentialScope ＋ “, ” ＋ “SignedHeaders=” ＋ SignedHeaders ＋ “, ” ＋ “Signature=” ＋ Signature
请求头 ＝ 请求头 ＋ “Authorization:” ＋ Authorization ＋ #换行符
请求头 ＝ 请求头 ＋ “Content-Type:application/json” ＋ #换行符
请求头 ＝ 请求头 ＋ “Host: ” ＋ API_URL ＋ #换行符
请求头 ＝ 请求头 ＋ “X-TC-Action: SendSms ” ＋ #换行符
请求头 ＝ 请求头 ＋ “X-TC-Timestamp:” ＋ RequestTimestamp ＋ #换行符
请求头 ＝ 请求头 ＋ “X-TC-Version: 2021-01-11” ＋ #换行符
请求头 ＝ 请求头 ＋ “X-TC-Region: ap-guangzhou” ＋ #换行符
请求头 ＝ 请求头 ＋ “X-TC-Language: zh-CN” ＋ #换行符
响应文本 ＝ 网页_访问S (“https://” ＋ API_URL, 1, HashedRequestPayload, , , 请求头, , , , , , , , , , , , , , , )
返回 (编码_utf8到gb2312 (响应文本))

子程序名	返回值类型	公开	备 注
匹配子域名	文本型		本子程序采用【精易编程助手】生成。成功返回匹配的文本，失败返回空文本。
参数名	类 型	参考	可空	数组	备 注
源文本	文本型				欲被匹配的文本
匹配索引	整数型				表达式的索引，从1开始将代表为子匹配文本的索引。
子匹配索引	整数型				可空。 子表达式的索引，从1开始将代表为子匹配文本的索引

变量名	类 型	静态	数组	备 注
局_正则	正则表达式类			此类为精易模块里面的正则类，精易模块下载地址：http://ec.125.la/

如果真 (局_正则.创建 (“(\w+).tencentcloudapi.com”, 源文本, 假, 假, 真, 真) ＝ 假)
信息框 (“正则创建失败，请检查正则表达式语句是否有误！”, #错误图标, , )
返回 (“”)
如果真 (局_正则.取匹配数量 () ＝ 0)
信息框 (“匹配失败，请检检查正则语句是否有误，数量：0”, #错误图标, , )
返回 (“”)
如果真 (匹配索引 ＜ 1)
信息框 (“参数二 - 匹配索引必须大于0。”, #错误图标, , )
返回 (“”)

判断 (匹配索引 ＞ 0 且 子匹配索引 ＞ 0)  ' 如果 匹配索引 和 子匹配索引 都大于0，则匹配子匹配文本
返回 (局_正则.取子匹配文本 (匹配索引, 子匹配索引, ))

判断 (匹配索引 ＞ 0)  ' 如果只有匹配索引大于0，则返回指定的匹配文本
返回 (局_正则.取匹配文本 (匹配索引, ))


返回 (“”)

i支持库列表	支持库注释
e2ee	E2EE互联网服务器套件

.版本 2<br /> .支持库 e2ee<br /> <br /> .子程序 TX云v3签名_POST_发送短xin, 文本型<br /> .参数 HashedRequestPayload, 文本型, , 提交数据{'PhoneNumberSet':['+8612345678900'],'SmsSdkAppId':'********','SignName':'****','TemplateId':'***','TemplateParamSet':['****']}<br /> .参数 SecretKey, 文本型, , 身份密钥<br /> .参数 SecretId, 文本型, , 身份ID<br /> .局部变量 a, 加解密对象<br /> .局部变量 CanonicalRequest, 文本型<br /> .局部变量 StringToSign, 文本型<br /> .局部变量 Algorithm, 文本型<br /> .局部变量 RequestTimestamp, 文本型<br /> .局部变量 CredentialScope, 文本型<br /> .局部变量 HashedCanonicalRequest, 文本型<br /> .局部变量 SecretDate, 文本型<br /> .局部变量 SecretService, 文本型<br /> .局部变量 SecretSigning, 文本型<br /> .局部变量 Signature, 文本型<br /> .局部变量 Authorization, 文本型<br /> .局部变量 SignedHeaders, 文本型<br /> .局部变量 API_URL, 文本型, , , ,<br /> .局部变量 请求头, 文本型<br /> .局部变量 响应文本, 文本型<br /> <br /> SignedHeaders ＝ “content-type;host;x-tc-action”<br /> API_URL ＝ “sms.tencentcloudapi.com”<br /> ' 1.拼接规范请求串<br /> CanonicalRequest ＝ “POST” ＋ 字符 (10) ＋ “/” ＋ 字符 (10) ＋ “” ＋ 字符 (10) ＋ “content-type:application/json” ＋ 字符 (10) ＋ “host:sms.tencentcloudapi.com” ＋ 字符 (10) ＋ “x-tc-action:sendsms” ＋ 字符 (10) ＋ “” ＋ 字符 (10) ＋ SignedHeaders ＋ 字符 (10) ＋ 校验_取sha256 (到字节集 (HashedRequestPayload))<br /> <br /> ' 2.拼接待签名字符串<br /> Algorithm ＝ “TC3-HMAC-SHA256”<br /> RequestTimestamp ＝ 时间_取现行时间戳 (真)<br /> ' RequestTimestamp ＝ “1713234015”<br /> CredentialScope ＝ 时间_格式化 (取现行时间 (), “yyyy-MM-dd”, , 真, ) ＋ “/” ＋ 匹配子域名 (API_URL, 1, 1) ＋ “/tc3_request”<br /> HashedCanonicalRequest ＝ 校验_取sha256 (到字节集 (CanonicalRequest))<br /> StringToSign ＝ Algorithm ＋ 字符 (10) ＋ RequestTimestamp ＋ 字符 (10) ＋ CredentialScope ＋ 字符 (10) ＋ HashedCanonicalRequest<br /> <br /> ' 3.计算签名<br /> SecretDate ＝ a.取HMAC值 (#哈希算法_SHA256, 时间_格式化 (取现行时间 (), “yyyy-MM-dd”, , 真, ), “TC3” ＋ SecretKey, )<br /> SecretService ＝ a.取HMAC值 (#哈希算法_SHA256, 匹配子域名 (API_URL, 1, 1), HEX解码 (SecretDate), )<br /> SecretSigning ＝ a.取HMAC值 (#哈希算法_SHA256, “tc3_request”, HEX解码 (SecretService), )<br /> Signature ＝ a.取HMAC值 (#哈希算法_SHA256, StringToSign, HEX解码 (SecretSigning), )<br /> <br /> ' 4.拼接 Authorization<br /> Authorization ＝ Algorithm ＋ “ ” ＋ “Credential=” ＋ SecretId ＋ “/” ＋ CredentialScope ＋ “, ” ＋ “SignedHeaders=” ＋ SignedHeaders ＋ “, ” ＋ “Signature=” ＋ Signature<br /> 请求头 ＝ 请求头 ＋ “Authorization:” ＋ Authorization ＋ #换行符<br /> 请求头 ＝ 请求头 ＋ “Content-Type:application/json” ＋ #换行符<br /> 请求头 ＝ 请求头 ＋ “Host: ” ＋ API_URL ＋ #换行符<br /> 请求头 ＝ 请求头 ＋ “X-TC-Action: SendSms ” ＋ #换行符<br /> 请求头 ＝ 请求头 ＋ “X-TC-Timestamp:” ＋ RequestTimestamp ＋ #换行符<br /> 请求头 ＝ 请求头 ＋ “X-TC-Version: 2021-01-11” ＋ #换行符<br /> 请求头 ＝ 请求头 ＋ “X-TC-Region: ap-guangzhou” ＋ #换行符<br /> 请求头 ＝ 请求头 ＋ “X-TC-Language: zh-CN” ＋ #换行符<br /> <br /> 响应文本 ＝ 网页_访问S (“https://” ＋ API_URL, 1, HashedRequestPayload, , , 请求头, , , , , , , , , , , , , , , )<br /> <br /> 返回 (编码_utf8到gb2312 (响应文本))<br /> <br /> <br /> .子程序 匹配子域名, 文本型, , 本子程序采用【精易编程助手】生成。成功返回匹配的文本，失败返回空文本。<br /> .参数 源文本, 文本型, , 欲被匹配的文本<br /> .参数 匹配索引, 整数型, , 表达式的索引，从1开始将代表为子匹配文本的索引。<br /> .参数 子匹配索引, 整数型, 可空, 可空。 子表达式的索引，从1开始将代表为子匹配文本的索引<br /> .局部变量 局_正则, 正则表达式类, , , 此类为精易模块里面的正则类，精易模块下载地址：<a href="http://ec.125.la/" rel="nofollow" rel="nofollow" rel="nofollow" target="_blank">http://ec.125.la/</a><br /> <br /> .如果真 (局_正则.创建 (“(\w+).tencentcloudapi.com”, 源文本, 假, 假, 真, 真) ＝ 假)<br />     信息框 (“正则创建失败，请检查正则表达式语句是否有误！”, #错误图标, , )<br />     返回 (“”)<br /> .如果真结束<br /> .如果真 (局_正则.取匹配数量 () ＝ 0)<br />     信息框 (“匹配失败，请检检查正则语句是否有误，数量：0”, #错误图标, , )<br />     返回 (“”)<br /> .如果真结束<br /> .如果真 (匹配索引 ＜ 1)<br />     信息框 (“参数二 - 匹配索引必须大于0。”, #错误图标, , )<br />     返回 (“”)<br /> .如果真结束<br /> <br /> .判断开始 (匹配索引 ＞ 0 且 子匹配索引 ＞ 0)  ' 如果 匹配索引 和 子匹配索引 都大于0，则匹配子匹配文本<br />     返回 (局_正则.取子匹配文本 (匹配索引, 子匹配索引, ))<br /> <br /> .判断 (匹配索引 ＞ 0)  ' 如果只有匹配索引大于0，则返回指定的匹配文本<br />     返回 (局_正则.取匹配文本 (匹配索引, ))<br /> .默认<br /> <br /> .判断结束<br /> 返回 (“”)

yingxuan

谢谢谢谢

qiujie117275706

官方文档https://cloud.tencent.com/document/product/1729/101843

xuehoo

谢谢分享

qiujie117275706

注意：

• Date 必须从时间戳 X-TC-Timestamp 计算得到，且时区为 UTC+0。如果加入系统本地时区信息，例如东八区，将导致白天和晚上调用成功，但是凌晨时调用必定失败。假设时间戳为 1551113065，在东八区的时间是 2019-02-26 00:44:25，但是计算得到的 Date 取 UTC+0 的日期应为 2019-02-25，而不是 2019-02-26。
• Timestamp 必须是当前系统时间，且需确保系统时间和标准时间是同步的，如果相差超过五分钟则必定失败。如果长时间不和标准时间同步，可能运行一段时间后，请求失败，返回签名过期错误。
  

  

CredentialScope ＝ 时间_格式化 (到时间 (时间_时间戳转文本 (到文本 (到长整数 (时间_取现行时间戳 (真)) － 28800), 2)), “yyyy-MM-dd”, , 真, ) ＋ “/” ＋ 匹配子域名 (API_URL, 1, 1) ＋ “/tc3_request”
SecretDate ＝ a.取HMAC值 ( #哈希算法_SHA256, 时间_格式化 (到时间 (时间_时间戳转文本 (到文本 (到长整数 (时间_取现行时间戳 (真)) － 28800), 2)), “yyyy-MM-dd”, , 真, ), “TC3” ＋ SecretKey, )

CredentialScope ＝ 时间_格式化 (到时间 (时间_时间戳转文本 (到文本 (到长整数 (时间_取现行时间戳 (真)) － 28800), 2)), “yyyy-MM-dd”, , 真, ) ＋ “/” ＋ 匹配子域名 (API_URL, 1, 1) ＋ “/tc3_request”<br /> <br /> SecretDate ＝ a.取HMAC值 (#哈希算法_SHA256, 时间_格式化 (到时间 (时间_时间戳转文本 (到文本 (到长整数 (时间_取现行时间戳 (真)) － 28800), 2)), “yyyy-MM-dd”, , 真, ), “TC3” ＋ SecretKey, )

chis777780

谢谢分享