短信发送API(SendSms)---PHP

来源：互联网发布：如何给网站做排名优化编辑：程序博客网时间：2024/05/20 01:45

短信发送API(SendSms)---PHP

更新时间：2017-08-17 15:16:35 分享：

发送短信接口(SendSms)

步骤 1 创建阿里云账号

为了访问短信服务，您需要有一个阿里云账号。如果没有，可首先按照如下步骤创建阿里云账号：

访问阿里云官方网站，单击页面上的免费注册按钮。
按照屏幕提示完成注册流程并进行实名认证，短信服务只支持实名认证用户使用。为了更好地使用阿里云服务，建议尽快完成实名认证，否则部分阿里云服务将无法使用。具体实名认证流程，请参考这里。

步骤 2 获取阿里云访问密钥

为了使用短信发送API-PHP SDK，您必须申请阿里云的访问密钥。

阿里云访问秘钥是阿里云为用户使用 API（非控制台）来访问其云资源设计的“安全口令”。您可以用它来签名 API 请求内容以通过服务端的安全验证。

该访问秘钥成对（AccessKeyId 与 AccessKeySecret）生成和使用。每个阿里云用户可以创建多对访问秘钥，且可随时启用（Active）、禁用（Inactive）或者删除已经生成的访问秘钥对。

您可以通过阿里云控制台的秘钥管理页面创建、管理所有的访问秘钥对，且保证它处于“启用”状态。由于访问秘钥是阿里云对 API 请求进行安全验证的关键因子，请妥善保管你的访问秘钥。如果某些秘钥对出现泄漏风险，建议及时删除该秘钥对并生成新的替代秘钥对。

步骤 3 在控制台完成模板与签名的申请，获得调用接口必备的参数

短信签名

根据用户属性来创建符合自身属性的签名信息。企业用户需要上传相关企业资质证明，个人用户需要上传证明个人身份的证明。

短信签名需要审核通过后才可以使用。

短信模板

短信模板，即具体发送的短信内容。

短信模板可以支持验证码、短信通知、推广短信三种模式。验证码和短信通知，通过变量替换实现个性短信定制。推广短信不支持在模板中添加变量。

短信模板需要审核通过后才可以使用。

为了成功发送一条短信通知，您至少需要完成以下步骤

一、在控制台完成短信全名与短信模板的申请，获得调用接口必备的参数

在“短信签名”页面完成签名的申请，获得短信签名的字符串签名申请手册

在“短信模板”页面完成模板的申请，获得模板ID。模板申请手册

入参列表

参数名称参数类型必填与否样例取值参数说明PhoneNumbersString必须15000000000短信接收号码。支持以逗号分隔的形式进行批量调用，批量上限为1000个手机号码,批量调用相对于单条调用及时性稍有延迟,验证码类型的短信推荐使用单条调用的方式SignNameString必须云通信短信签名TemplateCodeString必须SMS_0000短信模板IDTemplateParamString可选{“code”:”1234”,”product”:”ytx”}短信模板变量替换JSON串,友情提示:如果JSON中需要带换行符,请参照标准的JSON协议对换行符的要求,比如短信内容中包含\r\n的情况在JSON中需要表示成\r\n,否则会导致JSON在服务端解析失败OutIdString可选abcdefgh外部流水扩展字段

出参列表

出参名称出参类型样例取值参数说明RequestIdString8906582E-6722请求IDCodeStringOK状态码-返回OK代表请求成功,其他错误码详见错误码列表MessageString请求成功状态码的描述BizIdString134523^4351232发送回执ID,可根据该ID查询具体的发送状态

技术对接步骤

1:下载SDK工具包

SDK工具包中一共包含了2个类库，一个aliyun-php-sdk-core包，另外一个是alicom-dysms-api包，将这两个包添加到工程类库中依赖。

SDK&DEMO[下载地址]

2: 编写样例程序

//此处需要替换成自己的AK信息
    $accessKeyId = "yourAccessKeyId";//参考本文档步骤2
    $accessKeySecret = "yourAccessKeySecret";//参考本文档步骤2
    //短信API产品名（短信产品名固定，无需修改）
    $product = "Dysmsapi";
    //短信API产品域名（接口地址固定，无需修改）
    $domain = "dysmsapi.aliyuncs.com";
    //暂时不支持多Region（目前仅支持cn-hangzhou请勿修改）
    $region = "cn-hangzhou";
    //初始化访问的acsCleint
    $profile = DefaultProfile::getProfile($region, $accessKeyId, $accessKeySecret);
    DefaultProfile::addEndpoint("cn-hangzhou", "cn-hangzhou", $product, $domain);
    $acsClient= new DefaultAcsClient($profile);
    $request = new Dysmsapi\Request\V20170525\SendSmsRequest;
    //必填-短信接收号码。支持以逗号分隔的形式进行批量调用，批量上限为1000个手机号码,批量调用相对于单条调用及时性稍有延迟,验证码类型的短信推荐使用单条调用的方式
    $request->setPhoneNumbers("15067126468");
    //必填-短信签名
    $request->setSignName("云通信");
    //必填-短信模板Code
    $request->setTemplateCode("SMS_0001");
    //选填-假如模板中存在变量需要替换则为必填(JSON格式),友情提示:如果JSON中需要带换行符,请参照标准的JSON协议对换行符的要求,比如短信内容中包含\r\n的情况在JSON中需要表示成\\r\\n,否则会导致JSON在服务端解析失败
    $request->setTemplateParam("{\"code\":\"12345\",\"product\":\"云通信服务\"}");
    //选填-发送短信流水号
    $request->setOutId("1234");
    //发起访问请求
    $acsResponse = $acsClient->getAcsResponse($request);

错误码列表

Code描述OK请求成功isp.RAM_PERMISSION_DENYRAM权限DENYisv.OUT_OF_SERVICE业务停机isv.PRODUCT_UN_SUBSCRIPT未开通云通信产品的阿里云客户isv.PRODUCT_UNSUBSCRIBE产品未开通isv.ACCOUNT_NOT_EXISTS账户不存在isv.ACCOUNT_ABNORMAL账户异常isv.SMS_TEMPLATE_ILLEGAL短信模板不合法isv.SMS_SIGNATURE_ILLEGAL短信签名不合法isv.INVALID_PARAMETERS参数异常isp.SYSTEM_ERROR系统错误isv.MOBILE_NUMBER_ILLEGAL非法手机号isv.MOBILE_COUNT_OVER_LIMIT手机号码数量超过限制isv.TEMPLATE_MISSING_PARAMETERS模板缺少变量isv.BUSINESS_LIMIT_CONTROL业务限流isv.INVALID_JSON_PARAMJSON参数不合法，只接受字符串值isv.BLACK_KEY_CONTROL_LIMIT黑名单管控isv.PARAM_LENGTH_LIMIT参数超出长度限制isv.PARAM_NOT_SUPPORT_URL不支持URLisv.AMOUNT_NOT_ENOUGH账户余额不足

注：如传递中文出现乱码，请检查编码格式，建议使用utf-8

时间戳格式：

格式为：yyyy-MM-dd’T’HH:mm:ss’Z’；时区为：GMT

阅读全文

0 0