短信接口 API 文档

欢迎使用短信发送服务。本文档将指导您如何通过 API 快速集成短信发送功能。

1. 发送短信 (Send SMS)

调用此接口发送短信，支持模板变量替换。

请求参数

返回示例 (JSON)

{
  "code": 200,
  "msg": "短信发送成功",
  "data": {
    "phone": "138****1234",
    "template_id": "VERIFY_CODE",
    "cost": 0.50,
    "remaining_balance": 99.50,
    "remaining_sms": 9
  }
}

代码示例 (PHP)

<?php
// 发送短信验证码
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://gulangvision.cn/face/smsapi.php');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'api_key' => 'YOUR_API_KEY',
    'phone' => '13800138000',
    'template_id' => 'VERIFY_CODE',
    'variables' => json_encode(['code' => '123456'])
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result['code'] == 200) {
    echo "发送成功！剩余短信条数: " . $result['data']['remaining_sms'];
} else {
    echo '发送失败: ' . $result['msg'];
}
?>

📧 邮箱发送 API 文档

欢迎使用邮箱发送服务。本文档将指导您如何通过 API 快速集成邮件发送功能。

1. 发送邮件 (Send Email)

调用此接口发送邮件，支持HTML格式。

请求参数

返回示例 (JSON)

{
  "code": 200,
  "msg": "邮件发送成功",
  "data": {
    "to_email": "user@example.com",
    "subject": "验证码通知",
    "cost": 0.30,
    "remaining_balance": 99.20,
    "remaining_email": 19
  }
}

代码示例 - 表单格式 (PHP)

<?php
// 发送HTML邮件（表单格式）
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://gulangvision.cn/face/mailapi.php');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'api_key' => 'YOUR_API_KEY',
    'to_email' => 'user@example.com',
    'subject' => '验证码通知',
    'content' => '<h1>您的验证码是：123456</h1><p>5分钟内有效</p>'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result['code'] == 200) {
    echo "发送成功！";
} else {
    echo '发送失败: ' . $result['msg'];
}
?>

代码示例 - JSON格式 (PHP)

<?php
// 发送HTML邮件（JSON格式）
$data = [
    'api_key' => 'YOUR_API_KEY',
    'to_email' => 'user@example.com',
    'subject' => '验证码通知',
    'content' => '<h1>您的验证码是：123456</h1><p>5分钟内有效</p>'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://gulangvision.cn/face/mailapi.php');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result['code'] == 200) {
    echo "发送成功！";
} else {
    echo '发送失败: ' . $result['msg'];
}
?>

代码示例 - JavaScript (Fetch)

<script>
// 发送HTML邮件（JSON格式）
fetch('https://gulangvision.cn/face/mailapi.php', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        api_key: 'YOUR_API_KEY',
        to_email: 'user@example.com',
        subject: '验证码通知',
        content: '<h1>您的验证码是：123456</h1><p>5分钟内有效</p>'
    })
})
.then(res => res.json())
.then(data => {
    if (data.code == 200) {
        console.log('发送成功！');
    } else {
        console.log('发送失败:', data.msg);
    }
});
</script>

💰 计费说明

本文档说明所有服务的计费规则和扣费逻辑。

1. 扣费优先级

1. 优先扣除资源包 - 如果有短信条数/邮箱封数额度，优先扣除
2. 余额扣费 - 资源包不足或过期时，从余额扣除

2. 计费标准

3. 扣费示例

示例1：有短信条数额度
账户余额：¥100.00
短信条数：10条
发送1条短信后：
  - 短信条数：9条
  - 账户余额：¥100.00（不变）

示例2：无短信条数额度
账户余额：¥100.00
短信条数：0条
发送1条短信后：
  - 短信条数：0条
  - 账户余额：¥99.50（扣除¥0.50）

4. 实名认证要求

⚠️ 常见错误码

本文档列出所有可能的错误码及其解决方案。

实名认证错误码

短信&邮箱错误码

频率限制