检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API使用说明 API列表 发送短信 接收状态报告 接收上行短信 发送短信API:向单个或多个用户发送相同内容的短信 发送分批短信API:向多个用户发送不同内容的短信 接收状态报告API:用于接收短信发送状态报告 接收上行短信API:用于接收用户回复的短信 API请求地址 API
通过API使用消息&短信服务 短信服务提供短信发送、短信分批发送、接收状态报告,接收上行短信(国内短信)等API接口。获取更多信息,请参见API参考。 如有任何疑问,请联系华为云智能客服,将有专人为您解答。
云商店开放接口指南 接口使用方法 公共参数 接口列表 公共错误码 APIGW网关错误码 开放接口示例代码 父主题: 联营License客户端软件对接指南
资质提交支持API接口吗? 消息&短信服务申请资质暂未提供接口,请在短信控制台提交申请,具体操作请参见短信资质管理。 父主题: 资质相关
API概况 消息&短信服务所提供的接口,根据不同的API调用方式分为应用、签名、模板API和发送接收短信API。 表1 接口说明 类型 子类型 说明 应用、签名、模板API 短信应用API 可以实现查询短信应用、创建短信应用、查询应用数量、获取应用详情、修改短信应用等操作。 短信签名API
调用API 认证鉴权 父主题: 发送接收短信
对外API规范 API规范示例 为了对外API在调用时有用户信息,API调用时需要在header中传递Modifier、Creator字段。 值格式为:用户名+空格+用户id,如图1所示。
如何调用API 构造请求 认证鉴权 返回结果 父主题: 应用、签名、模板
"error_detail": "appKey=123" } error_code为API错误码字段,当您调用API时,如果遇到error_code 为“APIGW”开头的错误码,请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 错误码 错误信息 描述 处理措施 MSGSMS.0001
API 应用、签名、模板 发送接收短信
API错误码(发送短信) 本章节为调用API错误返回的错误码全集,数量较多,建议您使用快捷键Ctrl+F在界面进行搜索,找到您需要的错误码处理建议。 404问题处理 若调用接口时返回了404响应,请检查APP接入地址和访问URI(详见开发准备)是否都填写正确,且拼接成了完整的请求
短信接口支持内网调用吗(例如ECS服务器)? 不支持。短信接口不支持内网调用。如果您使用的华为云弹性云服务器,请申请绑定弹性IP地址,通过公网访问短信服务。 父主题: 二次开发相关
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于获取用户Token接口,您可以从接口的请求部分看到所需的请求参数及参数说
接口调用成功,但手机未收到短信是什么原因? 仅当发送短信请求中“statusCallback”参数已设置回调地址时,华为云短信服务才会推送状态报告通知。 如果您没有设置回调地址,请登录短信控制台,进入“发送详情”界面查看状态码。状态码详情请参考状态回执错误码(国内短信)。 请检查对应手机号码的短信状态报告是否已返回。
从发送短信API/发送分批短信API页面中的“接口类型”介绍部分获取。 发送短信:/sms/batchSendSms/v1 发送分批短信:/sms/batchSendDiffSms/v1 综上,短信API请求地址示例如下: 发送短信 https://smsapi.cn-north-4.myhuaweicloud
在我的凭证下,您可以查看账号ID和用户ID。通常在调用API的鉴权过程中,您需要用到账号、用户和密码等信息。 区域 指云资源所在的物理位置,同一区域内可用区间内网互通,不同区域间内网不互通。通过在不同地区创建云资源,可以将应用程序设计的更接近特定客户的要求,或满足不同地区的法律或其他要求。
如何处理调用短信API超时? 如果在您在服务器上调用短信API超时,没有响应。处理建议如下: 请检查请求地址是否正确,修正后重试。 请检查客户服务器IP地址是否为国际IP地址,被限制接入,建议购买国内服务器。 当您的业务满足如下两个要求时,可以申请将国际IP地址加入短信平台IP白名单:
发送接收短信 调用API API使用说明 发送短信 发送分批短信 接收状态报告 批量接收状态报告 接收上行短信 父主题: API
认证 在计算机系统中,Token代表令牌(临时),拥有Token就代表拥有某种权限。Token认证就是调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。 Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。 云服务存在两种部署方式:
认证鉴权 调用接口需通过特殊AK/SK认证或者X-WSSE认证。 推荐使用AK/SK签名认证方式,算法更安全。 特殊AK/SK认证(推荐) AK/SK签名认证方式仅支持12MB以内的消息体。 特殊AK/SK认证的“特殊”,是相对于一般AK/SK认证而言,AK、SK、EndPoin
请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于获取用户Token接口,返回如图1所示的消息头,其中“x-subject-tok
发送分批短信 功能介绍 该接口用于向单个或多个手机号发送不同内容的短信。 前提条件 已创建短信应用,获取APP_Key、APP_Secret和APP接入地址。 (仅国内短信)已申请短信签名,获取签名通道号。 已申请短信模板,获取模板ID。 调试 您可以参考发送分批短信API,进行快速上手调试。