PHP集成EnableX.io短信API：基础认证配置与常见问题解决

<?php

// 1. 配置API凭证和消息参数
// 请替换为您的EnableX.io APP_ID 和 APP_KEY
$appId = 'YOUR_ENABLEX_APP_ID'; 
$appKey = 'YOUR_ENABLEX_APP_KEY'; 

// 请替换为接收短信的手机号码（国际格式，如 +8613800138000）
$recipientNumber = 'YOUR_PHONE_NUMBER'; 

// 短信发送者ID，通常在EnableX.io后台配置
$senderId = 'SWULJP'; 

// 短信内容
$messageBody = 'Dear user, 12345 is the OTP to sign-in to swulj.com - Thanks Team SWULJ'; 

// 2. 构建HTTP请求头
$headers = array(
    'Content-Type: application/json',
    // 关键：Basic认证头，APP_ID和APP_KEY用冒号连接后进行Base64编码
    'Authorization: Basic ' . base64_encode($appId . ':' . $appKey)
);

// 3. 构建POST请求体数据
// 根据EnableX.io短信API文档构建请求参数
$postData = array(
    'from'      => $senderId,        // 发送者ID
    'body'      => $messageBody,      // 短信内容
    'direct'    => false,             // 是否直接发送到收件人，通常设置为false，使用顶层body
    'recipient' => array(             // 收件人列表
        array(
            'to' => $recipientNumber, // 接收短信的手机号码
            // 'body' => 'This body supercedes with direct: true', // 如果direct为true，这里可以覆盖顶层body
            // 'uuid' => 'Optional UUID for recipient' // 可选的收件人唯一标识
        )
    ),
    'type'      => 'sms',             // 消息类型，这里是短信
    'reference' => 'XOXO',            // 您的内部引用ID
    'validity'  => '30',              // 短信有效期，单位分钟
    // 'type_details' => '',          // 更多类型详情，按需添加
    // 'data_coding' => 'plain',      // 数据编码
    // 'flash_message' => false,      // 是否为闪信
    // 'campaign_id' => '25550516',   // 您的营销活动ID，按需添加
    // 'template_id' => '1215'        // 您的短信模板ID，按需添加
);

// 4. 发送cURL请求
$ch = curl_init('https://api.enablex.io/sms/v1/messages/');
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);             // 设置HTTP请求头
curl_setopt($ch, CURLOPT_POST, true);                       // 设置为POST请求
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postData)); // 设置POST请求体，需要JSON编码
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);             // 获取响应作为字符串返回
// 生产环境中建议设置为true并配置CA证书，以确保SSL安全
// curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
// curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 开发环境中可设置为false，跳过SSL证书验证

$response = curl_exec($ch);      // 执行cURL请求
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 获取HTTP状态码
$error = curl_error($ch);        // 获取cURL错误信息

curl_close($ch); // 关闭cURL会话

// 5. 处理API响应
if ($response === false) {
    echo "cURL Error: " . $error . "\n";
} else {
    echo "HTTP Status Code: " . $httpCode . "\n";
    echo "API Response: " . $response . "\n";

    // 解析API响应
    $responseData = json_decode($response, true);
    // 根据EnableX.io文档，通常result为1表示成功
    if (isset($responseData['result']) && $responseData['result'] == 1) {
        echo "短信发送成功！Job ID: " . $responseData['job_id'] . "\n";
    } else {
        echo "短信发送失败。\n";
        // 进一步检查EnableX.io可能返回的详细错误信息
        if (isset($responseData['error_code'])) {
            echo "错误码 (Error Code): " . $responseData['error_code'] . "\n";
        }
        if (isset($responseData['error_message'])) {
            echo "错误信息 (Error Message): " . $responseData['error_message'] . "\n";
        }
        // 对于{"result":0,"job_id":"..."}这样的响应，在认证失败时，
        // 尽管result为0，但通常表示操作未成功或权限不足。
        // 建议查阅EnableX.io官方文档中关于错误码的详细说明。
    }
}

?>