云服务器内容精选

  • 如何判断短信发送成功? 查看调用发送短信/发送分批短信API接口的响应消息,确认关键参数取值如下: 一个请求响应只对应一个code,一个手机号码对应一个status。 参数 取值 说明 code 000000 表示请求成功,请查看“status”取值。 status 000000 表示短信平台处理请求成功,用户是否成功收到短信,请查看“短信状态报告”。 查看短信发送状态报告,确认关键参数取值如下: 只有在调用发送短信/发送分批短信API接口时,通过请求Body中的“statusCallback”参数指定了回调地址,才能接收短信状态报告。请参考接收状态报告。 步骤1请求成功且消息&短信平台未给您返回失败的状态报告,就算发送成功。 参数 取值 说明 status DELIVRD 表示短信发送成功,用户已成功收到短信。 短信状态报告中的“status”参数取值为“DELIVRD”,则表示短信发送成功。 如果没有状态报告回调地址,请登录短信控制台,进入“发送详情”界面查看发送结果。若“发送结果”显示“成功”,“状态码”显示“DELIVRD”,则表示短信发送成功。 父主题: 短信发送相关
  • 响应示例 状态码: 200 发送短信响应体。 { "status" : "Success", "result" : [ { "to" : "+86139274****8", "channel_num" : "8823060****9", "msg_id" : "b24f1f03-556e-468e-9fe1-23729b9414d7_72****6", "create_time" : "2023-08-11T12:11:24", "send_status" : "000000" }, { "to" : "+861552****978", "channel_num" : "8823060806439", "msg_id" : "b24f1f03-556e-468e-9fe1-23729b9414d7_****407", "create_time" : "2023-08-11T12:11:24", "send_status" : "000000" } ], "task_id" : "a914ca57-09cf-4899-af62-f9a****06c3c"}
  • 请求示例 向用户发送短信,短信通道号为882306039,模板ID为1512。 https://koomessage.myhuaweicloud.cn/v1/aim/sms/messages{ "channel_num" : "8823060****39", "template_id" : "1512****", "signature" : "测试签名", "app_name" : "OPACCOUNT688", "task_name" : "测试发送", "to" : [ "139274****98", "15527****78" ], "template_params" : [ "kXfvIwzs" ]}
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 task_id String 任务ID。 最小长度:1 最大长度:50 status String 任务状态。 Success:发送成功 Failed:发送失败 说明: 此状态仅代表任务提交状态,不代表智能信息发送结果。用户手机接收智能信息结果请以收到的回执结果为准,也可通过查询智能信息发送明细API获取或登录 KooMessage 控制台查看。 最小长度:1 最大长度:20 result Array of SmsDetailResponse objects 短信ID列表,当目标号码存在多个时,每个号码都会返回一个SmsID。 当返回异常响应时不携带此字段。 表4 SmsDetailResponse 参数 参数类型 描述 to String 短信接收方的号码。 最小长度:1 最大长度:21 channel_num String 短信发送方的号码。 最小长度:1 最大长度:21 msg_id String 短信的唯一标识。 最小长度:1 最大长度:50 send_status String 短信状态码。 以下举例状态码及其说明,具体处理建议请参考API错误码。 000000:短信平台处理请求成功 E200015:待发送短信数量太大 E200028:模板变量校验失败 E200029:模板类型校验失败 E200030:模板未激活 E200031:协议校验失败 E200033:模板类型不正确 E200041:同一短信内容接收号码重复 最小长度:1 最大长度:7 create_time String 短信资源的创建时间。 即短信平台接收到用户发送短信请求的时间,为UTC时间。 格式为:yyyy-MM-dd'T'HH:mm:ss'Z'。 最小长度:1 最大长度:20 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 最小长度:0 最大长度:32 error_msg String 结果详情。 最小长度:0 最大长度:32 状态码: 500 表6 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 最小长度:0 最大长度:32 error_msg String 结果详情。 最小长度:0 最大长度:32
  • 为何短信发送过了很久才收到状态报告? 问题描述: 调用短信API发送短信请求成功,但过了很久用户才收到短信发送状态报告。 原因分析: 短信平台已将短信请求发送到运营商短信网关,但运营商短信网关未及时返回短信发送状态报告给短信平台。 正常情况下,运营商短信网关会在秒级返回短信发送状态报告。遇到异常情况(如手机关机、手机欠费停机、信号不好、网络波动、短信内容被运营商审核等)时,运营商短信网关返回状态可能不及时。 还可能是发送的短信内容触发了运营商的人工审核流程,通常一个模板初次触发人工审核通过后,后续就不会再触发。 父主题: 短信发送详情