tencentcloud-sdk-nodejs
Version:
1,156 lines (1,155 loc) • 43.6 kB
TypeScript
/**
* PullSmsReplyStatus请求参数结构体
*/
export interface PullSmsReplyStatusRequest {
/**
* 拉取最大条数,最多100条。
*/
Limit: number;
/**
* 短信 SdkAppId 在 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 添加应用后生成的实际 SdkAppId,例如1400006666。
*/
SmsSdkAppId: string;
}
/**
* DeleteSmsTemplate返回参数结构体
*/
export interface DeleteSmsTemplateResponse {
/**
* 删除模板响应
*/
DeleteTemplateStatus?: DeleteTemplateStatus;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ModifySmsTemplate返回参数结构体
*/
export interface ModifySmsTemplateResponse {
/**
* 修改模板参数响应
*/
ModifyTemplateStatus?: ModifyTemplateStatus;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ModifySmsSign请求参数结构体
*/
export interface ModifySmsSignRequest {
/**
* <p>待修改的签名 ID。</p>
*/
SignId: number;
/**
* <p>签名名称。</p>
*/
SignName: string;
/**
* <p>签名类型。其中每种类型后面标注了其可选的 DocumentType(证明类型):<br>0:公司,可选 DocumentType 有(0,1)。<br>1:APP,可选 DocumentType 有(0,1,2,3,4) 。<br>4:商标,可选 DocumentType 有(7)。<br>5:政府/机关事业单位/其他机构,可选 DocumentType 有(2,3)。<br>注1:必须按照对应关系选择证明类型,否则会审核失败。<br>注2:签名类型2(网站)、3(公众号)、6(小程序)已不再支持,具体可参考 <a href="https://cloud.tencent.com/document/product/382/116397">关于腾讯云短信签名申请规则更新的公告</a>。<br>注3:申请国内短信签名已不再支持签名类型1(APP),具体可参考 <a href="https://cloud.tencent.com/announce/detail/2256">关于腾讯云短信签名申请规则更新的公告</a>。</p>
*/
SignType: number;
/**
* <p>证明类型:<br>0:三证合一。<br>1:企业营业执照。<br>2:组织机构代码证书。<br>3:社会信用代码证书。<br>4:应用后台管理截图(个人开发APP)。<br>7:商标注册书。<br>注1:证明类型5(网站备案后台截图)、6(小程序设置页面截图)、8(公众号设置页面截图)已不再支持,具体可参考 <a href="https://cloud.tencent.com/document/product/382/116397">关于腾讯云短信签名申请规则更新的公告</a>。<br>注2:申请国内短信签名已不再支持证明类型4(应用后台管理截图),具体可参考 <a href="https://cloud.tencent.com/announce/detail/2256">关于腾讯云短信签名申请规则更新的公告</a>。</p>
*/
DocumentType: number;
/**
* <p>是否国际/港澳台短信:<br>0:表示国内短信。<br>1:表示国际/港澳台短信。<br>注:需要和待修改签名International值保持一致,该参数不能直接修改国内签名到国际签名。</p>
*/
International: number;
/**
* <p>签名用途:<br>0:自用。<br>1:他用。</p>
*/
SignPurpose: number;
/**
* <p>签名对应的资质证明图片需先进行 base64 编码格式转换,将转换后的字符串去掉前缀<code>data:image/jpeg;base64,</code>再赋值给该参数。</p>
*/
ProofImage: string;
/**
* <p>委托授权证明。选择 SignPurpose 为他用之后需要提交委托的授权证明。<br>图片需先进行 base64 编码格式转换,将转换后的字符串去掉前缀<code>data:image/jpeg;base64,</code>再赋值给该参数。<br>注:只有 SignPurpose 在选择为 1(他用)时,这个字段才会生效。</p>
*/
CommissionImage?: string;
/**
* <p>签名的申请备注。</p>
*/
Remark?: string;
/**
* <p>已审核通过的国内短信的资质 ID。资质 ID 信息可前往国内短信的 <a href="https://console.cloud.tencent.com/smsv2/enterprise">实名资质管理</a> 页查看。<blockquote class="rno-document-tips rno-document-tips-notice"> <div class="rno-document-tips-body"> <i class="rno-document-tip-icon"></i> <div class="rno-document-tip-title">说明</div> <div class="rno-document-tip-desc"><ul><li>国内短信需填写资质ID,国际短信无需填写。</li></ul></div> </div></blockquote></p>
*/
QualificationId?: number;
}
/**
* SmsPackagesStatistics请求参数结构体
*/
export interface SmsPackagesStatisticsRequest {
/**
* 短信 SdkAppId 在 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 添加应用后生成的实际 SdkAppId,示例如1400006666。
*/
SmsSdkAppId: string;
/**
* 最大上限(需要拉取的套餐包个数)。
注:Limit默认最大值为500,可结合Offset实现分页查询。
*/
Limit: number;
/**
* 偏移量。
*/
Offset: number;
/**
* 起始时间,格式为yyyymmddhh,精确到小时,例如2024050113,表示2024年5月1号13时。
注:接口会返回 BeginTime 到 EndTime 之间创建的套餐包的统计信息。
*/
BeginTime: string;
/**
* 结束时间,格式为yyyymmddhh,精确到小时,例如2024050118,表示2024年5月1号18时。
注:EndTime 必须大于 BeginTime 且小于当前时间。
*/
EndTime: string;
}
/**
* 转化率上报响应。
*/
export interface ReportConversionStatus {
/**
* 错误码。上报成功返回 ok。
*/
Code: string;
/**
* 错误码描述。
*/
Message: string;
}
/**
* AddSmsSign请求参数结构体
*/
export interface AddSmsSignRequest {
/**
* <p>签名名称。<br>注:不能重复申请已通过或待审核的签名。</p>
*/
SignName: string;
/**
* <p>签名类型。其中每种类型后面标注了其可选的 DocumentType(证明类型):<br>0:公司,可选 DocumentType 有(0,1)。<br>1:APP,可选 DocumentType 有(0,1,2,3,4) 。<br>4:商标,可选 DocumentType 有(7)。<br>5:政府/机关事业单位/其他机构,可选 DocumentType 有(2,3)。<br>注1:必须按照对应关系选择证明类型,否则会审核失败。<br>注2:签名类型2(网站)、3(公众号)、6(小程序)已不再支持,具体可参考 <a href="https://cloud.tencent.com/document/product/382/116397">关于腾讯云短信签名申请规则更新的公告</a>。<br>注3:申请国内短信签名已不再支持签名类型1(APP),具体可参考 <a href="https://cloud.tencent.com/announce/detail/2256">关于腾讯云短信签名申请规则更新的公告</a>。</p>
*/
SignType: number;
/**
* <p>证明类型:<br>0:三证合一。<br>1:企业营业执照。<br>2:组织机构代码证书。<br>3:社会信用代码证书。<br>4:应用后台管理截图(个人开发APP)。<br>7:商标注册书。<br>注1:证明类型5(网站备案后台截图)、6(小程序设置页面截图)、8(公众号设置页面截图)已不再支持,具体可参考 <a href="https://cloud.tencent.com/document/product/382/116397">关于腾讯云短信签名申请规则更新的公告</a>。<br>注2:申请国内短信签名已不再支持证明类型4(应用后台管理截图),具体可参考 <a href="https://cloud.tencent.com/announce/detail/2256">关于腾讯云短信签名申请规则更新的公告</a>。</p>
*/
DocumentType: number;
/**
* <p>是否国际/港澳台短信:<br>0:表示国内短信。<br>1:表示国际/港澳台短信。</p>
*/
International: number;
/**
* <p>签名用途:<br>0:自用。<br>1:他用。</p>
*/
SignPurpose: number;
/**
* <p>签名对应的资质证明图片需先进行 base64 编码格式转换,将转换后的字符串去掉前缀<code>data:image/jpeg;base64,</code>再赋值给该参数。</p>
*/
ProofImage: string;
/**
* <p>委托授权证明。选择 SignPurpose 为他用之后需要提交委托的授权证明。<br>图片需先进行 base64 编码格式转换,将转换后的字符串去掉前缀<code>data:image/jpeg;base64,</code>再赋值给该参数。<br>注:只有 SignPurpose 在选择为 1(他用)时,这个字段才会生效。</p>
*/
CommissionImage?: string;
/**
* <p>签名的申请备注。</p>
*/
Remark?: string;
/**
* <p>已审核通过的国内短信的资质 ID。资质 ID 信息可前往国内短信的 <a href="https://console.cloud.tencent.com/smsv2/enterprise">实名资质管理</a> 页查看。<blockquote class="rno-document-tips rno-document-tips-notice"> <div class="rno-document-tips-body"> <i class="rno-document-tip-icon"></i> <div class="rno-document-tip-title">说明</div> <div class="rno-document-tip-desc"><ul><li>国内短信需填写资质ID,国际短信无需填写。</li></ul></div> </div></blockquote></p>
*/
QualificationId?: number;
}
/**
* 添加模板参数响应
*/
export interface AddTemplateStatus {
/**
* 模板ID。
*/
TemplateId: string;
}
/**
* DescribeSmsTemplateList返回参数结构体
*/
export interface DescribeSmsTemplateListResponse {
/**
* 获取短信模板信息响应
*/
DescribeTemplateStatusSet?: Array<DescribeTemplateListStatus>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribePhoneNumberInfo请求参数结构体
*/
export interface DescribePhoneNumberInfoRequest {
/**
* 查询手机号码,采用 E.164 标准,格式为+[国家或地区码][手机号],单次请求最多支持200个手机号。
例如:+8618501234444, 其中前面有一个+号 ,86为国家码,18501234444为手机号。
*/
PhoneNumberSet: Array<string>;
}
/**
* PullSmsSendStatusByPhoneNumber请求参数结构体
*/
export interface PullSmsSendStatusByPhoneNumberRequest {
/**
* 拉取起始时间,UNIX 时间戳(时间:秒)。
注:最大可拉取当前时期前7天的数据。
*/
BeginTime: number;
/**
* 偏移量。
注:目前固定设置为0。
*/
Offset: number;
/**
* 拉取最大条数,最多 100。
*/
Limit: number;
/**
* 下发目的手机号码,依据 E.164 标准为:+[国家(或地区)码][手机号] ,示例如:+8618501234444, 其中前面有一个+号 ,86为国家码,18501234444为手机号。
*/
PhoneNumber: string;
/**
* 短信 SdkAppId 在 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 添加应用后生成的实际 SdkAppId,示例如1400006666。
*/
SmsSdkAppId: string;
/**
* 拉取截止时间,UNIX 时间戳(时间:秒)。
*/
EndTime?: number;
}
/**
* ReportConversion返回参数结构体
*/
export interface ReportConversionResponse {
/**
* 转化率上报响应包体。
*/
ReportConversionStatus?: ReportConversionStatus;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* AddSmsTemplate请求参数结构体
*/
export interface AddSmsTemplateRequest {
/**
* 模板名称。
*/
TemplateName: string;
/**
* 模板内容。
*/
TemplateContent: string;
/**
* 短信类型,1表示营销短信,2表示通知短信,3表示验证码短信。
注:为进一步提升短信发送质量、提高短信模板审核通过率,从2024年5月16日起,腾讯云短信模板类型优化为“验证码短信”、“通知短信”、“营销短信”,可参考[关于腾讯云短信模板类型优化公告](https://cloud.tencent.com/document/product/382/106171)。新开通短信服务的客户需严格参考新的短信类型申请短信模板。
*/
SmsType: number;
/**
* 是否国际/港澳台短信:
0:表示国内短信。
1:表示国际/港澳台短信。
*/
International: number;
/**
* 模板备注,例如申请原因,使用场景等。
*/
Remark: string;
}
/**
* ModifySmsTemplate请求参数结构体
*/
export interface ModifySmsTemplateRequest {
/**
* 待修改模板的ID。
*/
TemplateId: number;
/**
* 新的模板名称。
*/
TemplateName: string;
/**
* 新的模板内容。
*/
TemplateContent: string;
/**
* 短信类型,1表示营销短信,2表示通知短信,3表示验证码短信。
注:为进一步提升短信发送质量、提高短信模板审核通过率,从2024年5月16日起,腾讯云短信模板类型优化为“验证码短信”、“通知短信”、“营销短信”,可参考[关于腾讯云短信模板类型优化公告](https://cloud.tencent.com/document/product/382/106171)。新开通短信服务的客户需严格参考新的短信类型申请短信模板。
*/
SmsType: number;
/**
* 是否国际/港澳台短信:
0:表示国内短信。
1:表示国际/港澳台短信。
注:需要和待修改模板 International 值保持一致,该参数不能直接修改国内模板到国际模板。
*/
International: number;
/**
* 模板备注,例如申请原因,使用场景等。
*/
Remark: string;
}
/**
* 短信回复状态
*/
export interface PullSmsReplyStatus {
/**
* 短信码号扩展号,默认未开通,如需开通请联系 [sms helper](https://cloud.tencent.com/document/product/382/3773#.E6.8A.80.E6.9C.AF.E4.BA.A4.E6.B5.81)。
*/
ExtendCode?: string;
/**
* 国家(或地区)码。
*/
CountryCode?: string;
/**
* 手机号码,E.164标准,+[国家或地区码][手机号] ,示例如:+8618501234444, 其中前面有一个+号 ,86为国家码,18501234444为手机号。
*/
PhoneNumber?: string;
/**
* 短信签名名称。
*/
SignName?: string;
/**
* 用户回复的内容。
*/
ReplyContent?: string;
/**
* 回复时间,UNIX 时间戳(单位:秒)。
*/
ReplyTime?: number;
/**
* 用户号码,普通格式,示例如:18501234444。
*/
SubscriberNumber?: string;
}
/**
* CallbackStatusStatistics返回参数结构体
*/
export interface CallbackStatusStatisticsResponse {
/**
* 回执数据统计响应包体。
*/
CallbackStatusStatistics?: CallbackStatusStatistics;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* PullSmsSendStatus请求参数结构体
*/
export interface PullSmsSendStatusRequest {
/**
* 拉取最大条数,最多100条。
*/
Limit: number;
/**
* 短信 SdkAppId 在 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 添加应用后生成的实际 SdkAppId,例如1400006666。
*/
SmsSdkAppId: string;
}
/**
* 套餐包信息统计响应包体
*/
export interface SmsPackagesStatistics {
/**
* <p>套餐包创建时间,UNIX 时间戳。</p><p>单位:秒</p>
*/
PackageCreateTime?: number;
/**
* <p>套餐包生效时间,UNIX 时间戳。</p><p>单位:秒</p>
*/
PackageEffectiveTime?: number;
/**
* <p>套餐包过期时间,UNIX 时间戳。</p><p>单位:秒</p>
*/
PackageExpiredTime?: number;
/**
* <p>套餐包条数。</p><p>单位:条</p>
*/
PackageAmount?: number;
/**
* <p>套餐包类别。</p><p>枚举值:</p><ul><li>0: 赠送套餐</li><li>1: 购买套餐包</li></ul>
*/
PackageType?: number;
/**
* <p>套餐包 ID。</p>
*/
PackageId?: number;
/**
* <p>当前使用套餐包条数。</p><p>单位:条</p>
*/
CurrentUsage?: number;
}
/**
* PullSmsSendStatusByPhoneNumber返回参数结构体
*/
export interface PullSmsSendStatusByPhoneNumberResponse {
/**
* 下发状态响应集合。
*/
PullSmsSendStatusSet?: Array<PullSmsSendStatus>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 修改签名响应
*/
export interface ModifySignStatus {
/**
* 签名ID。
*/
SignId: number;
}
/**
* 获取短信签名信息响应
*/
export interface DescribeSignListStatus {
/**
* 签名ID。
*/
SignId?: number;
/**
* 是否国际/港澳台短信,其中0表示国内短信,1表示国际/港澳台短信。
*/
International?: number;
/**
* 签名状态,其中:
国内短信0表示签名可用,1表示审核中,2表示审核通过待生效,-1表示审核未通过、审核失败或未完成首次报备等原因导致签名不可用。具体可参考 [国内短信签名状态值说明](https://cloud.tencent.com/document/product/382/39022#ea7b2b63-ee71-404f-a525-c5a572d12ccd)。
国际短信0表示审核通过且已生效,1表示审核中,2表示审核通过待生效,-1表示审核未通过或审核失败。
*/
StatusCode?: number;
/**
* 审核回复,审核人员审核后给出的回复,通常是审核未通过的原因。
*/
ReviewReply?: string;
/**
* 签名名称。
*/
SignName?: string;
/**
* 提交审核时间,UNIX 时间戳(单位:秒)。
*/
CreateTime?: number;
/**
* 国内短信的资质 ID。资质 ID 信息可前往国内短信的 [实名资质管理](https://console.cloud.tencent.com/smsv2/enterprise) 页查看。
注:国际短信不涉及,默认为0。
*/
QualificationId?: number;
/**
* 国内短信的资质名称。
注:国际短信不涉及,默认为空。
*/
QualificationName?: string;
/**
* 国内短信的资质状态。其中0表示待审核,1表示已通过,2表示已拒绝,3表示待补充后提交,4表示变更后待审核,5表示变更后被驳回。可参考 [实名资质审核状态说明](https://cloud.tencent.com/document/product/382/13444#.E5.AE.A1.E6.A0.B8.E7.8A.B6.E6.80.81.E8.AF.B4.E6.98.8E) 。
注:国际短信不涉及,默认为0。
*/
QualificationStatusCode?: number;
}
/**
* SendSms返回参数结构体
*/
export interface SendSmsResponse {
/**
* 短信发送状态。
注:可参考 <a href="#4.-.E7.A4.BA.E4.BE.8B">示例</a> ,包含短信发送成功和发送失败的输出示例。
*/
SendStatusSet?: Array<SendStatus>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* SendStatusStatistics返回参数结构体
*/
export interface SendStatusStatisticsResponse {
/**
* 发送数据统计响应包体。
*/
SendStatusStatistics?: SendStatusStatistics;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* SendSms请求参数结构体
*/
export interface SendSmsRequest {
/**
* 下发手机号码,采用 E.164 标准,格式为+[国家或地区码][手机号],单次请求最多支持200个手机号且要求全为境内手机号或全为境外手机号。
例如:+8618501234444, 其中前面有一个+号 ,86为国家码,18501234444为手机号。
注:发送国内短信格式还支持0086、86或无任何国家或地区码的11位手机号码,前缀默认为+86。
*/
PhoneNumberSet: Array<string>;
/**
* 短信 SdkAppId,在 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 添加应用后生成的实际 SdkAppId,示例如1400006666。
*/
SmsSdkAppId: string;
/**
* 模板 ID,必须填写已审核通过的模板 ID。模板 ID 可前往 [国内短信](https://console.cloud.tencent.com/smsv2/csms-template) 或 [国际/港澳台短信](https://console.cloud.tencent.com/smsv2/isms-template) 的正文模板管理查看,若向境外手机号发送短信,仅支持使用国际/港澳台短信模板。
*/
TemplateId: string;
/**
* 短信签名内容,使用 UTF-8 编码,必须填写已审核通过的签名,例如:腾讯云,签名信息可前往 [国内短信](https://console.cloud.tencent.com/smsv2/csms-sign) 或 [国际/港澳台短信](https://console.cloud.tencent.com/smsv2/isms-sign) 的签名管理查看。
<dx-alert infotype="notice" title="注意"><ul><li>发送国内短信该参数必填,且需填写签名内容而非签名ID。
</li><li>发送国际/港澳台短信该参数非必填。</li></ul></dx-alert>
*/
SignName?: string;
/**
* 模板参数,若无模板参数,则设置为空。
<dx-alert infotype="notice" title="注意">模板参数的个数需要与 TemplateId 对应模板的变量个数保持一致。</dx-alert>
*/
TemplateParamSet?: Array<string>;
/**
* 短信码号扩展号,默认未开通,如需开通请联系 [腾讯云短信小助手](https://cloud.tencent.com/document/product/382/3773#.E6.8A.80.E6.9C.AF.E4.BA.A4.E6.B5.81)。
*/
ExtendCode?: string;
/**
* 用户的 session 内容,可以携带用户侧 ID 等上下文信息,server 会原样返回。注意长度需小于512字节。
*/
SessionContext?: string;
/**
* 国际/港澳台短信 Sender ID。可参考 [Sender ID 说明](https://cloud.tencent.com/document/product/382/102831)。
注:国内短信无需填写该项;国际/港澳台短信已申请独立 SenderId 需要填写该字段,默认使用公共 SenderId,无需填写该字段。
*/
SenderId?: string;
}
/**
* 发送数据统计响应包体
*/
export interface SendStatusStatistics {
/**
* 短信计费条数统计,例如提交成功量为100条,其中有20条是长短信(长度为80字)被拆分成2条,则计费条数为: ```80 * 1 + 20 * 2 = 120``` 条。
*/
FeeCount?: number;
/**
* 短信提交量统计。
*/
RequestCount?: number;
/**
* 短信提交成功量统计。
*/
RequestSuccessCount?: number;
}
/**
* CallbackStatusStatistics请求参数结构体
*/
export interface CallbackStatusStatisticsRequest {
/**
* 起始时间,格式为yyyymmddhh,精确到小时,例如2024050113,表示2024年5月1号13时。
*/
BeginTime: string;
/**
* 结束时间,格式为yyyymmddhh,精确到小时,例如2024050118,表示2024年5月1号18时。
注:EndTime 必须大于等于 BeginTime,且相差不超过32天。
*/
EndTime: string;
/**
* 短信 SdkAppId 在 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 添加应用后生成的实际 SdkAppId,示例如1400006666。
*/
SmsSdkAppId: string;
/**
* 最大上限。
注:目前固定设置为0。
*/
Limit: number;
/**
* 偏移量。
注:目前固定设置为0。
*/
Offset: number;
}
/**
* 删除模板响应
*/
export interface DeleteTemplateStatus {
/**
* 删除状态信息。
*/
DeleteStatus?: string;
/**
* 删除时间,UNIX 时间戳(单位:秒)。
*/
DeleteTime?: number;
}
/**
* DescribeSmsSignList请求参数结构体
*/
export interface DescribeSmsSignListRequest {
/**
* <p>是否国际/港澳台短信:<br>0:表示国内短信。<br>1:表示国际/港澳台短信。</p>
*/
International: number;
/**
* <p>签名 ID 数组。<br>注:默认数组最大长度100。</p>
*/
SignIdSet?: Array<number | bigint>;
/**
* <p>最大上限,最多100。注:默认为10,SignIdSet 为空时启用。</p>
*/
Limit?: number;
/**
* <p>偏移量。注:默认为0,SignIdSet 为空时启用。</p>
*/
Offset?: number;
}
/**
* DescribePhoneNumberInfo返回参数结构体
*/
export interface DescribePhoneNumberInfoResponse {
/**
* 获取号码信息。
*/
PhoneNumberInfoSet?: Array<PhoneNumberInfo>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 获取短信模板信息响应
*/
export interface DescribeTemplateListStatus {
/**
* 模板ID。
*/
TemplateId?: number;
/**
* 是否国际/港澳台短信,其中0表示国内短信,1表示国际/港澳台短信,3表示该模板既支持国内短信也支持国际/港澳台短信。
*/
International?: number;
/**
* 申请模板状态,其中0表示审核通过且已生效,1表示审核中,2表示审核通过待生效,-1表示审核未通过或审核失败。注:只有状态值为0时该模板才能使用。
*/
StatusCode?: number;
/**
* 审核回复,审核人员审核后给出的回复,通常是审核未通过的原因。
*/
ReviewReply?: string;
/**
* 模板名称。
*/
TemplateName?: string;
/**
* 提交审核时间,UNIX 时间戳(单位:秒)。
*/
CreateTime?: number;
/**
* 模板内容。
*/
TemplateContent?: string;
}
/**
* 发送短信状态
*/
export interface SendMultiStatus {
/**
* <p>发送流水号。</p>
*/
SerialNo?: string;
/**
* <p>手机号码,E.164标准,+[国家或地区码][手机号] ,示例如:+60198890000, 其中前面有一个+号 ,60为国家码,198890000为手机号。</p>
*/
PhoneNumber?: string;
/**
* <p>计费条数,计费规则请查询 <a href="https://cloud.tencent.com/document/product/382/36135">计费策略</a>。</p>
*/
Fee?: number;
/**
* <p>用户 session 内容。</p>
*/
SessionContext?: string;
/**
* <p>短信请求错误码,具体含义请参考 <a href="https://cloud.tencent.com/document/product/382/59177#.E7.9F.AD.E4.BF.A1-API-3.0-.E5.8F.91.E9.80.81.E9.94.99.E8.AF.AF.E7.A0.81">错误码</a>,发送成功返回 "Ok"。</p>
*/
Code?: string;
/**
* <p>短信请求错误码描述。</p>
*/
Message?: string;
/**
* <p>国家码或地区码,例如 US、MY 等,对于未识别出国家码或者地区码,默认返回 DEF,具体支持列表请参考 <a href="https://cloud.tencent.com/document/product/382/18051">国际/港澳台短信价格总览</a>。</p>
*/
IsoCode?: string;
}
/**
* AddSmsTemplate返回参数结构体
*/
export interface AddSmsTemplateResponse {
/**
* 添加短信模板响应包体
*/
AddTemplateStatus?: AddTemplateStatus;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 短信的下发状态详细信息
*/
export interface PullSmsSendStatus {
/**
* 用户实际接收到短信的时间,UNIX 时间戳(单位:秒)。
*/
UserReceiveTime?: number;
/**
* 国家(或地区)码。
*/
CountryCode?: string;
/**
* 用户号码,普通格式,示例如:18501234444。
*/
SubscriberNumber?: string;
/**
* 手机号码,E.164标准,+[国家或地区码][手机号] ,示例如:+8618501234444, 其中前面有一个+号 ,86为国家码,18501234444为手机号。
*/
PhoneNumber?: string;
/**
* 本次发送标识 ID。
*/
SerialNo?: string;
/**
* 实际是否收到的短信接收状态,SUCCESS(下发成功)、FAIL(下发失败)。
注:仅当运营商有返回短信接收状态时回包中才会有状态数据。
*/
ReportStatus?: string;
/**
* 用户接收短信状态描述。
*/
Description?: string;
/**
* 用户的 session 内容。与请求中的 SessionContext 一致,默认为空,如需开通请联系 [腾讯云短信小助手](https://cloud.tencent.com/document/product/382/3773#.E6.8A.80.E6.9C.AF.E4.BA.A4.E6.B5.81) 评估。
*/
SessionContext?: string;
}
/**
* DescribeSmsSignList返回参数结构体
*/
export interface DescribeSmsSignListResponse {
/**
* <p>获取签名信息响应</p>
*/
DescribeSignListStatusSet?: Array<DescribeSignListStatus>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* SendMultiGlobalSms返回参数结构体
*/
export interface SendMultiGlobalSmsResponse {
/**
* <p>短信批量发送状态。</p>
*/
SendMultiStatusSet?: Array<SendMultiStatus>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeSmsTemplateList请求参数结构体
*/
export interface DescribeSmsTemplateListRequest {
/**
* 是否国际/港澳台短信:
0:表示国内短信。
1:表示国际/港澳台短信。
*/
International: number;
/**
* 模板 ID 数组。数组为空时默认查询模板列表信息,请使用 Limit 和 Offset 字段设置查询范围。
<dx-alert infotype="notice" title="注意">默认数组长度最大100</dx-alert>
*/
TemplateIdSet?: Array<number | bigint>;
/**
* 最大上限,最多100。
注:默认为0,TemplateIdSet 为空时启用。
*/
Limit?: number;
/**
* 偏移量。
注:默认为0,TemplateIdSet 为空时启用。
*/
Offset?: number;
}
/**
* 回执数据统计响应包体
*/
export interface CallbackStatusStatistics {
/**
* <p>短信回执量统计。</p><p>单位:个</p>
*/
CallbackCount?: number;
/**
* <p>短信提交成功量统计。</p><p>单位:个</p>
*/
RequestSuccessCount?: number;
/**
* <p>短信回执失败量统计。</p><p>单位:个</p>
*/
CallbackFailCount?: number;
/**
* <p>短信回执成功量统计。</p><p>单位:个</p>
*/
CallbackSuccessCount?: number;
/**
* <p>运营商内部错误统计。</p><p>单位:个</p>
*/
InternalErrorCount?: number;
/**
* <p>号码无效或空号统计。</p><p>单位:个</p>
*/
InvalidNumberCount?: number;
/**
* <p>停机、关机等错误统计。</p><p>单位:个</p>
*/
ShutdownErrorCount?: number;
/**
* <p>号码拉入免打扰名单统计。</p><p>单位:个</p>
*/
BlackListCount?: number;
/**
* <p>运营商频率限制统计。</p><p>单位:个</p>
*/
FrequencyLimitCount?: number;
}
/**
* 号码信息。
*/
export interface PhoneNumberInfo {
/**
* 号码信息查询错误码,查询成功返回 "Ok"。
*/
Code?: string;
/**
* 号码信息查询错误码描述。
*/
Message?: string;
/**
* 国家(或地区)码。
*/
NationCode?: string;
/**
* 用户号码,去除国家或地区码前缀的普通格式,示例如:18501234444。
*/
SubscriberNumber?: string;
/**
* 解析后的规范的 E.164 号码,与下发短信的号码解析结果一致。解析失败时会原样返回。
*/
PhoneNumber?: string;
/**
* 国家码或地区码,例如 CN、US 等,对于未识别出国家码或者地区码,默认返回 DEF。
*/
IsoCode?: string;
/**
* 国家码或地区名,例如 China,可参考 [国际/港澳台短信价格总览](https://cloud.tencent.com/document/product/382/18051)
*/
IsoName?: string;
}
/**
* SendStatusStatistics请求参数结构体
*/
export interface SendStatusStatisticsRequest {
/**
* 起始时间,格式为yyyymmddhh,精确到小时,例如2024050113,表示2024年5月1号13时。
*/
BeginTime: string;
/**
* 结束时间,格式为yyyymmddhh,精确到小时,例如2024050118,表示2024年5月1号18时。
注:EndTime 必须大于等于 BeginTime。
*/
EndTime: string;
/**
* 短信 SdkAppId 在 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 添加应用后生成的实际 SdkAppId,示例如1400006666。
*/
SmsSdkAppId: string;
/**
* 最大上限。
注:目前固定设置为0。
*/
Limit: number;
/**
* 偏移量。
注:目前固定设置为0。
*/
Offset: number;
}
/**
* DeleteSmsTemplate请求参数结构体
*/
export interface DeleteSmsTemplateRequest {
/**
* 待删除的模板 ID。
*/
TemplateId: number;
}
/**
* PullSmsReplyStatusByPhoneNumber返回参数结构体
*/
export interface PullSmsReplyStatusByPhoneNumberResponse {
/**
* 回复状态响应集合。
*/
PullSmsReplyStatusSet?: Array<PullSmsReplyStatus>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 批量发送中每个手机号的发送信息。
*/
export interface MultiSmsInfo {
/**
* <p>下发手机号码,采用 E.164 标准,格式为+[国家或地区码][手机号],单次请求最多支持200个手机号且要求全为国际/港澳台手机号。 例如:+60198890000, 其中前面有一个+号 ,60为国家码,198890000为手机号。</p>
*/
PhoneNumber: string;
/**
* <p>模板 ID,必须填写已审核通过的模板 ID。模板 ID 可前往 <a href="https://console.cloud.tencent.com/smsv2/isms-template">国际/港澳台短信</a> 的正文模板管理查看,仅支持使用国际/港澳台短信模板。</p>
*/
TemplateId: string;
/**
* <p>模板参数,若无模板参数,则设置为空。<blockquote class="rno-document-tips rno-document-tips-notice"> <div class="rno-document-tips-body"> <i class="rno-document-tip-icon"></i> <div class="rno-document-tip-title">注意</div> <div class="rno-document-tip-desc"><p>模板参数的个数需要与 TemplateId 对应模板的变量个数保持一致。</p></div> </div></blockquote></p>
*/
TemplateParamSet?: Array<string>;
/**
* <p>国际/港澳台短信 Sender ID。可参考 <a href="https://cloud.tencent.com/document/product/382/102831">Sender ID 说明</a>。注:国际/港澳台短信已申请独立 SenderId 需要填写该字段,默认使用公共 SenderId,无需填写该字段。</p>
*/
SenderId?: string;
/**
* <p>用户的 session 内容,可以携带用户侧 ID 等上下文信息,server 会原样返回。注意长度需小于512字节。</p>
*/
SessionContext?: string;
}
/**
* DeleteSmsSign返回参数结构体
*/
export interface DeleteSmsSignResponse {
/**
* 删除签名响应
*/
DeleteSignStatus?: DeleteSignStatus;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* AddSmsSign返回参数结构体
*/
export interface AddSmsSignResponse {
/**
* <p>添加签名响应</p>
*/
AddSignStatus?: AddSignStatus;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DeleteSmsSign请求参数结构体
*/
export interface DeleteSmsSignRequest {
/**
* 待删除的签名 ID。
*/
SignId: number;
}
/**
* SendMultiGlobalSms请求参数结构体
*/
export interface SendMultiGlobalSmsRequest {
/**
* <p>短信 SdkAppId,在 <a href="https://console.cloud.tencent.com/smsv2/app-manage">短信控制台</a> 添加应用后生成的实际 SdkAppId。</p>
*/
SmsSdkAppId: string;
/**
* <p>批量发送信息列表,单次请求最多支持200个号码且要求全为国际/港澳台号码。每个元素包含一个手机号码及其对应的模板、模板参数等信息。</p>
*/
MultiSmsInfoSet: Array<MultiSmsInfo>;
}
/**
* PullSmsReplyStatusByPhoneNumber请求参数结构体
*/
export interface PullSmsReplyStatusByPhoneNumberRequest {
/**
* 拉取起始时间,UNIX 时间戳(时间:秒)。
注:最大可拉取当前时期前7天的数据。
*/
BeginTime: number;
/**
* 偏移量。
注:目前固定设置为0。
*/
Offset: number;
/**
* 拉取最大条数,最多 100。
*/
Limit: number;
/**
* 下发目的手机号码,依据 E.164 标准为:+[国家(或地区)码][手机号] ,示例如:+8618501234444, 其中前面有一个+号 ,86为国家码,18501234444为手机号。
*/
PhoneNumber: string;
/**
* 短信 SdkAppId 在 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 添加应用后生成的实际 SdkAppId,示例如1400006666。
*/
SmsSdkAppId: string;
/**
* 拉取截止时间,UNIX 时间戳(时间:秒)。
*/
EndTime?: number;
}
/**
* ModifySmsSign返回参数结构体
*/
export interface ModifySmsSignResponse {
/**
* <p>修改签名响应</p>
*/
ModifySignStatus?: ModifySignStatus;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ReportConversion请求参数结构体
*/
export interface ReportConversionRequest {
/**
* 短信应用ID。在 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 添加应用后生成的实际 SdkAppId,示例如1400006666。
*/
SmsSdkAppId: string;
/**
* 发送短信返回的流水号。对应SendSms接口返回的SendStatusSet参数中的SerialNo字段。
*/
SerialNo: string;
/**
* 用户回填时间,UNIX 时间戳(单位:秒)。
*/
ConversionTime?: number;
}
/**
* 添加签名响应
*/
export interface AddSignStatus {
/**
* 签名ID。
*/
SignId: number;
}
/**
* 修改模板参数响应
*/
export interface ModifyTemplateStatus {
/**
* 模板ID。
*/
TemplateId: number;
}
/**
* PullSmsSendStatus返回参数结构体
*/
export interface PullSmsSendStatusResponse {
/**
* 下发状态响应集合。
*/
PullSmsSendStatusSet?: Array<PullSmsSendStatus>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* SmsPackagesStatistics返回参数结构体
*/
export interface SmsPackagesStatisticsResponse {
/**
* 发送数据统计响应包体。
*/
SmsPackagesStatisticsSet?: Array<SmsPackagesStatistics>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 删除签名响应
*/
export interface DeleteSignStatus {
/**
* <p>删除状态信息。</p>
*/
DeleteStatus: string;
/**
* <p>删除时间,UNIX 时间戳(单位:秒)。</p>
*/
DeleteTime: number;
}
/**
* PullSmsReplyStatus返回参数结构体
*/
export interface PullSmsReplyStatusResponse {
/**
* 回复状态响应集合。
*/
PullSmsReplyStatusSet?: Array<PullSmsReplyStatus>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 发送短信状态
*/
export interface SendStatus {
/**
* 发送流水号。
*/
SerialNo?: string;
/**
* 手机号码,E.164标准,+[国家或地区码][手机号] ,示例如:+8618501234444, 其中前面有一个+号 ,86为国家码,18501234444为手机号。
*/
PhoneNumber?: string;
/**
* 计费条数,计费规则请查询 [计费策略](https://cloud.tencent.com/document/product/382/36135)。
*/
Fee?: number;
/**
* 用户 session 内容。
*/
SessionContext?: string;
/**
* 短信请求错误码,具体含义请参考 [错误码](https://cloud.tencent.com/document/product/382/59177#.E7.9F.AD.E4.BF.A1-API-3.0-.E5.8F.91.E9.80.81.E9.94.99.E8.AF.AF.E7.A0.81),发送成功返回 "Ok"。
*/
Code?: string;
/**
* 短信请求错误码描述。
*/
Message?: string;
/**
* 国家码或地区码,例如 CN、US 等,对于未识别出国家码或者地区码,默认返回 DEF,具体支持列表请参考 [国际/港澳台短信价格总览](https://cloud.tencent.com/document/product/382/18051)。
*/
IsoCode?: string;
}