文档首页/ IoT云通信 IoTCom/ 开发指南/ API样例代码/ PHP
更新时间：2022-09-16 GMT+08:00
查看PDF
分享

PHP

  • 本文档所述Demo在提供服务的过程中，可能会涉及个人数据的使用，建议您遵从国家的相关法律采取足够的措施，以确保用户的个人数据受到充分的保护。
  • 本文档所述Demo仅用于功能演示，不允许客户直接进行商业使用。
  • 本文档信息仅供参考，不构成任何要约或承诺。

发送短信

<?php 
 
 
//必填,请参考"开发准备"获取如下数据,替换为实际值 
//请求参数 
$url = 'https://ip:port/common/sms/sendTemplateMessage'; //APP接入地址+接口访问URI 
$templateId  = 'templateId_123'; //模板ID 
$account = 'xxxxxx';//实际账号 
$password = 'xxxxxx';//实际密码 
 
 
//条件必填,国内短信关注,当templateId指定的模板类型为通用模板时生效且必填,必须是已审核通过的,与模板类型一致的签名名称 
$signature = '短信测试'; //签名名称 
 
 
//必填,全局号码格式(不包含国家码),示例:12345678911,多个号码之间用英文逗号分隔 
$mobiles = array("12345678911");//短信接收人号码 
 
 
/** 
 * 选填,使用无变量模板时请赋空值 
 * 单变量模板示例:模板内容为"您的验证码是${param1}"时,$templateParas['param1']='参数值' 
  * 模板中的每个变量都必须赋值，且取值不能为空  
 * @var string $templateParas 
 */ 
$templateParas['parameter1']='parameter value1'; //parameter1 为变量参数名称，parameter value1为变量参数值
 
 
//状态报告通知地址，根据实际情况修改 
$statusCallback = 'https://ip:port/xx/xx'; 
 
 
//请求Headers 
$headers = [ 
    'Content-Type: application/json;charset=UTF-8' 
]; 
 
 
$requestLists['mobiles']=$mobiles; 
$requestLists['templateId']=$templateId; 
$requestLists['templateParas']=$templateParas; 
$requestLists['signature']=$signature; 
 
 
//请求Body 
$data['account']=$account; 
$data['password']=$password; 
$data['requestLists']=array($requestLists); 
$data['statusCallback']=$statusCallback; 
 
 
$context_options = [ 
    'http' => ['method' => 'POST', 'header'=> $headers, 'content' => json_encode($data, JSON_UNESCAPED_UNICODE|JSON_PRETTY_PRINT), 'ignore_errors' => true], 
    'ssl' => ['verify_peer' => false, 'verify_peer_name' => false] //为防止因HTTPS证书认证失败造成API调用失败，需要先忽略证书信任问题 
]; 
print_r($context_options) . PHP_EOL; //打印请求信息 
$response = file_get_contents($url, false, stream_context_create($context_options)); 
print_r($response) . PHP_EOL; //打印响应信息 
 
 
?>

上行短信接收

<?php
// 上行短信通知样例(urlencode)
$upData = 'mobile=%2B12345678911&content=***&sendTime=20220127020758&extCode=';

onSmsUpData($upData);

/**
 * 解析上行短信通知数据
 *
 * @param string $data 短信平台推送的上行短信通知数据
 */
function onSmsUpData(string $data)
{
    $keyValues = [];
    parse_str(urldecode($data), $keyValues); //解析上行短信通知数据

    /**
     * Example: 此处以解析content为例,请按需解析所需参数并自行实现相关处理
     *
     * 'mobile': 上行短信手机号
     * 'content': 短信内容
     * 'sendTime': 上行短信时间
     * 'extCode': 扩展码
     */
    $content = $keyValues['content']; // 上行短信发送的内容
    print 'Sms up data. Content: ' . $content . PHP_EOL;
}
?>

状态报告接收

<?php
// 短信平台上报状态报告数据样例(urlencode)
// $success_body = 'requestId=20220126&mobile=12345678911&messageId=2022012619403400&status=DELIVRD&resultCode=000000&resultDesc=success&smsCount=null&receiveTime=null';
$failed_body = 'requestId=20220126&mobile=12345678911&messageId=2022012619403400&status=E200027&resultCode=1020001&resultDesc=Parameter error&smsCount=null&receiveTime=null';

// onSmsStatusReport($success_body);
onSmsStatusReport($failed_body);

/**
 * 解析状态报告数据
 *
 * @param string $data 短信平台上报的状态报告数据
 */
function onSmsStatusReport(string $data)
{
    $keyValues = [];
    parse_str(urldecode($data), $keyValues); //解析状态报告数据

    /**
     * Example: 此处以解析status为例,请按需解析所需参数并自行实现相关处理
     *
     * 'messageId': 短信唯一标识
     * 'smsCount': 长短信拆分条数
     * 'receiveTime': 资源更新时间
     * 'status': 状态码
     */
    $status = $keyValues['status']; // 状态报告枚举值
    // 通过status判断短信是否发送成功
    if ('DELIVRD' === strtoupper($status)) {
        print 'Send sms success. messageId: ' . $keyValues['messageId'] . PHP_EOL;
    } else {
        // 发送失败,打印status
        print 'Send sms failed. messageId: ' . $keyValues['messageId'] . PHP_EOL;
        print 'Failed status: ' . $status . PHP_EOL;
    }
}
?>
父主题： API样例代码

相关文档