Skip to content
Permalink
Fetching contributors…
Cannot retrieve contributors at this time
154 lines (128 sloc) 6.38 KB

SDK 功能简介

目前腾讯云短信为客户提供国内短信国际/港澳台短信服务,腾讯云短信 SDK 支持以下操作:

国内短信 国际/港澳台短信
  • 指定模板单发短信
  • 指定模板群发短信
  • 拉取短信回执和短信回复状态
  • 指定模板单发短信
  • 指定模板群发短信
  • 拉取短信回执
  • ?

    • 群发短信 一次群发请求最多支持200个号码,如对号码数量有特殊需求请联系腾讯云短信技术支持(QQ:3012203387)。
    • 拉取短信回执 该功能默认关闭。您可以根据实际需求联系腾讯云短信技术支持(QQ:3012203387)开通,实现批量拉取短信回执。

    SDK 使用指南

    相关资料

    各个接口及其参数的详情介绍请参见 API 指南SDK 文档错误码

    前提条件

    在使用 SDK 前,您需要准备以下信息:

    • 获取 SDKAppID 和 AppKey 云短信应用 SDKAppIDAppKey 可在 短信控制台 的应用信息里获取。如您尚未添加应用,请登录 短信控制台 添加应用。
    • 申请签名并确认审核通过 一个完整的短信由短信签名短信正文内容两部分组成,短信签名需申请和审核,签名可在 短信控制台 的相应服务模块【内容配置】中进行申请,详细申请操作请参见 创建签名。发送国际/港澳台短信时,允许不携带签名。
    • 申请模板并确认审核通过 短信正文内容模板需申请和审核,模板可在 短信控制台 的相应服务模块【内容配置】中进行申请,详细申请操作请参见 创建正文模板

    配置 SDK

    • Composer 配置: qcloudsms_php 采用 composer 进行安装,要使用 qcloudsms 功能,只需要在 composer.json 中添加如下依赖:
    {
        "require": {
            "qcloudsms/qcloudsms_php": "0.1.*"
        }
    }

    ? Composer 的使用可以参考 demo 目录下面的示例。

    • 手动配置:
    1. 手动下载或 clone 最新版本 qcloudsms_php 代码。
    2. 把 qcloudsms_php src 目录下的代码放入 Autoloading 目录。
    3. 引入 require qcloudsms_php src 目录下面的 index.php 即可使用,如把 qcloudsms 放在当前目录下,只需要执行以下命令:
    require __DIR__ . "/qcloudsms_php/src/index.php";
    

    示例代码

    ?所有示例代码仅作参考,无法直接编译和运行,需根据实际情况进行修改。

    • 准备必要参数
    // 短信应用 SDK AppID
    $appid = 1400009099; // SDK AppID 以1400开头
    // 短信应用 SDK AppKey
    $appkey = "9ff91d87c2cd7cd0ea762f141975d1df37481d48700d70ac37470aefc60f9bad";
    // 需要发送短信的手机号码
    $phoneNumbers = ["21212313123", "12345678902", "12345678903"];
    // 短信模板 ID,需要在短信控制台中申请
    $templateId = 7839;  // NOTE: 这里的模板 ID`7839`只是示例,真实的模板 ID 需要在短信控制台中申请
    $smsSign = "腾讯云"; // NOTE: 签名参数使用的是`签名内容`,而不是`签名ID`。这里的签名"腾讯云"只是示例,真实的签名需要在短信控制台申请

    • 指定模板 ID 单发短信
    use Qcloud\Sms\SmsSingleSender;
    try {
        $ssender = new SmsSingleSender($appid, $appkey);
        $params = ["5678"];
        $result = $ssender->sendWithParam("86", $phoneNumbers[0], $templateId,
            $params, $smsSign, "", "");
        $rsp = json_decode($result);
        echo $result;
    } catch(\Exception $e) {
        echo var_dump($e);
    }

    • 指定模板 ID 群发短信
    use Qcloud\Sms\SmsMultiSender;
    try {
        $msender = new SmsMultiSender($appid, $appkey);
        $params = ["5678"];
        $result = $msender->sendWithParam("86", $phoneNumbers,
            $templateId, $params, $smsSign, "", "");
        $rsp = json_decode($result);
        echo $result;
    } catch(\Exception $e) {
        echo var_dump($e);
    }

    • 拉取短信回执以及回复
    use Qcloud\Sms\SmsStatusPuller;
    try {
        $spuller = new SmsStatusPuller($appid, $appkey);
    
        // 拉取短信回执
        $callbackResult = $spuller->pullCallback(10);
        $callbackRsp = json_decode($callbackResult);
        echo $callbackResult;
    
        // 拉取回复,国际/港澳台短信不支持回复功能
        $replyResult = $spuller->pullReply(10);
        $replyRsp = json_decode($replyResult);
        echo $replyResult;
    } catch (\Exception $e) {
        echo var_dump($e);
    }
    • 拉取单个手机短信状态
    use Qcloud\Sms\SmsMobileStatusPuller;
    try {
        $beginTime = 1511125600;  // 开始时间(UNIX timestamp)
        $endTime = 1511841600;    // 结束时间(UNIX timestamp)
        $maxNum = 10;             // 单次拉取最大量
        $mspuller = new SmsMobileStatusPuller($appid, $appkey);
    
        // 拉取短信回执
        $callbackResult = $mspuller->pullCallback("86", $phoneNumbers[0],
            $beginTime, $endTime, $maxNum);
        $callbackRsp = json_decode($callbackResult);
        echo $callbackResult;
    
        // 拉取回复,国际/港澳台短信不支持回复功能
        $replyResult = $mspuller->pullReply("86", $phoneNumbers[0],
            $beginTime, $endTime, $maxNum);
        $replyRsp = json_decode($replyResult);
        echo $replyResult;
    } catch (\Exception $e) {
        echo var_dump($e);
    }
    You can’t perform that action at this time.