短信发送接口

用于发送短信验证码，支持4-6位数字验证码

接口地址

                            https://sms.losels.eu.org/api/send.php
                        

请求方式

GET POST

认证方式

API Key

本接口用于发送短信验证码，目前仅支持验证码类型短信发送，支持4-6位数字验证码。所有API密钥关联的用户需要完成实名认证后才能发送短信。

请求参数

参数名	类型	必填	说明	示例
`api_key`	String	必填	API密钥，用于身份验证	`a1b2c3d4e5f6g7h8`
`phone`	String	必填	接收短信的手机号，11位中国大陆手机号	`13800138000`
`code`	String	必填	验证码内容，4-6位数字	`123456`

请求示例

GET 请求

POST 请求

PHP 示例

https://sms.losels.eu.org/api/send.php?api_key=your_api_key&phone=13800138000&code=123456

POST https://sms.losels.eu.org/api/send.php

Content-Type: application/x-www-form-urlencoded

api_key=your_api_key&phone=13800138000&code=123456

// 使用 cURL 发送 POST 请求
$apiUrl = 'https://sms.losels.eu.org/api/send.php';
$params = [
    'api_key' => 'your_api_key',
    'phone' => '13800138000',
    'code' => '123456'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

$result = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// 处理响应
$response = json_decode($result, true);
if ($response && $response['success']) {
    echo '发送成功';
} else {
    echo '发送失败: ' . ($response['message'] ?? '未知错误');
}

响应参数

参数名	类型	说明	示例
`success`	Boolean	请求是否成功	`true`
`code`	String	状态码，成功为"0"，失败为其他值（均为字符串类型）	`"0"`
`message`	String	状态信息	`发送成功`
`data`	Object/Array	返回数据，包含短信余额、消息ID、时间戳等信息	`{...}`

成功响应示例

{
    "success": true,
    "code": "0",
    "message": "短信发送成功",
    "data": {
        "sms_balance": 999,
        "message_id": "sms_6789abcdef",
        "timestamp": 1737734400,
        "phone": "13800138000",
        "code": "123456",
        "realname_verified": true,
        "api_provider": "SysKey",
        "request_id": "req_123456789"
    }
}

错误码说明

错误码	说明	可能原因
"-1"	参数错误	缺少必填参数、参数格式不正确、手机号格式错误或验证码格式错误
"-2"	服务器空间不支持	服务器配置问题，请联系空间商解决或更换空间
"30"	密码错误	第三方服务商认证失败
"40"	API密钥无效	api_key不存在、已过期或格式错误
"41"	余额不足	短信余额不足，请及时充值
"42"	帐户已过期	账户已过期，请联系管理员
"43"	IP地址限制	当前IP不在白名单中
"44"	用户未实名认证	用户未完成实名认证，无法发送短信
"50"	内容含有敏感词	短信内容包含敏感词汇，无法发送
"-10"	短信内容包含网址	短信内容包含网址，无法发送
"-11"	短信内容无意义	短信内容无意义，无法发送
"-12"	短信内容包含违禁关键字	短信内容包含违禁关键字，无法发送
"429"	请求频率超限	发送频率过高，请稍后重试

错误响应示例

{
    "success": false,
    "code": "44",
    "message": "用户未实名认证，无法发送短信",
    "data": []
}

注意事项

API密钥安全

请妥善保管您的API密钥，不要泄露给他人。建议在服务器端调用接口，避免在前端暴露密钥。所有API密钥关联的用户需要完成实名认证后才能发送短信。

频率限制

为防止滥用，系统对发送频率有限制。建议合理控制发送频率，避免触发限制。错误码"429"表示请求频率超限。

错误处理

调用接口时请务必检查响应中的success字段和code字段，根据错误码进行相应的错误处理。所有错误码均为字符串类型。

功能限制

目前仅支持验证码类型短信发送，不支持营销短信、通知短信等其他类型。验证码内容必须为4-6位纯数字。

实名认证要求

所有用户必须完成实名认证后才能使用短信发送功能。如未认证，将返回错误码"44"。请确保在调用API前已完成认证。