检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 构造请求 认证鉴权 返回结果 父主题： 应用、签名、模板
调用说明 消息&短信提供了REST（Representational State Transfer）风格API，支持您使用HTTPS协议通过域名（请勿直接使用IP）请求调用，调用方法请参见API。 如有任何疑问，请联系华为云智能客服，将有专人为您解答。 父主题： 使用前必读
调用API 认证鉴权 父主题： 发送接收短信
获取调用信息 获取终端节点 获取账号、用户、项目的名称和ID 父主题： 应用、签名、模板
短信业务API调用是否对PHP、Java等工具有版本要求？ 短信业务API调用跟工具版本没有关系，客户可以自行开发程序调用。短信Demo对PHP、Java等工具有版本要求，具体请参考短信代码样例。 父主题： 二次开发相关
调用接口发送短信时，填写的手机号码有格式要求吗？ 调用发送短信API和发送分批短信API时，请求参数“to”用于填写短信接收方的号码，标准号码格式为：+{国家码}{地区码}{终端号码}。 发送国内短信，如果“+{国家码}”不存在，则默认为+86，如果接收方号码为手机号码，则{地区
如何处理调用短信API超时？ 如果在您在服务器上调用短信API超时，没有响应。处理建议如下： 请检查请求地址是否正确，修正后重试。 请检查客户服务器IP地址是否为国际IP地址，被限制接入，建议购买国内服务器。 当您的业务满足如下两个要求时，可以申请将国际IP地址加入短信平台IP白名单：
接口调用成功，但手机未收到短信是什么原因？ 仅当发送短信请求中“statusCallback”参数已设置回调地址时，华为云短信服务才会推送状态报告通知。 如果您没有设置回调地址，请登录短信控制台，进入“发送详情”界面查看状态码。状态码详情请参考状态回执错误码（国内短信）。 请检查对应手机号码的短信状态报告是否已返回。
短信接口支持内网调用吗（例如ECS服务器）？ 不支持。短信接口不支持内网调用。如果您使用的华为云弹性云服务器，请申请绑定弹性IP地址，通过公网访问短信服务。 父主题： 二次开发相关
调用短信API，出现SSL连接异常类报错，如何处理？ 短信平台暂未开放HTTPS调测证书，需忽略证书校验，请前往代码样例查看“忽略证书信任”相关样例。 父主题： 故障排除
的签名SDK对请求进行签名。 本手册提供Java、Go、Python、C等多种不同语言的签名SDK和调用示例，您可以从签名SDK与demo中选择需要的语言，然后参考示例与API调用说明部分，将SDK集成到您的应用中。 签名SDK与demo中，获取AK/SK之处，需要替换为从消息&
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证通用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。
图2 查看账号名、账号ID、用户名、用户ID、项目名称、项目ID 调用API获取用户ID、项目ID 获取用户ID请参考：管理员查询IAM用户列表。 获取项目ID请参考：查询指定条件下的项目列表。 父主题： 获取调用信息
使用的短信模板（如验证码类通用模板对应所有验证码类签名）。对国内短信来说，验证码类、通知类短信和推广类短信均支持通用模板。 图1 通用模板关系图 前提条件 已创建模板所属短信应用。 已创建与通用模板同类型的短信签名，确保签名已审核通过，否则在选择“模板类型”和“所属应用”之后，“
构造请求 本节如何构造REST API的请求，并以调用IAM服务的获取用户Token说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987
cn-south-1.myhuaweicloud.com 说明： Endpoint只能使用域名请求，不能使用ip直接请求。 父主题： 获取调用信息
响应的状态，完整的状态码列表请参见状态码。 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于获取用户T
索，找到您需要的错误码处理建议。 调用发送短信/发送分批短信接口会产生接口调用错误码，详见API错误码。 调用接口成功后，如果“statusCallback”参数指定了回调地址，则短信平台在接收到运营商短信网关返回的短信发送状态报告时，会主动调用接收状态报告接口将短信状态报告推送给客户。
客户有能接收HTTP/HTTPS协议POST请求的服务器，且提供的URL地址能通过公网访问。 状态报告接收地址是指客户用于接收短信平台推送的状态报告通知的地址。 客户调用短信业务API发送短信时，通过“statusCallback”参数携带该地址。消息&短信服务通过回调该地址，向客户推送已发送短信的状态报告通知。
申请推广类签名，怎么算是已有订购关系的会员？ 消息&短信服务支持给有订购关系的会员用户提供推广短信服务。 已有订购关系的会员，可以理解为用户已经注册成华为云会员，或者已经购买过华为云服务后又加入会员，非潜在客户或意向客户。只要有会员证明就可以看作是已有订购关系的会员。 申请推广类签名时
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
