FluxSMS 短信接口调用说明

一、短信接口

用于发送国内或国际短信，每个用户国内/国际各限 3 条免费测试。

测试模板

调用示例

国内测试（传入 c=123456，手机实际收到：「您的验证码是123456，有效期5分钟。」）

https://sms.vdesin.com/api.php?u=用户名&p=密钥&m=13800138000&c=123456&type=china

国际测试（传入 c=123456，手机实际收到：「Dear user, your verification code is 123456。」）

https://sms.vdesin.com/api.php?u=用户名&p=密钥&m=85298765432&c=123456&type=global

参数说明

• u：注册用户名
• p：API 密钥（登录用户中心查看）
• m：目标手机号
• c：验证码数字（国内4-6位 / 国际6位），系统自动套入上方固定模板
• type：china（国内）或 global（国际）

返回示例（成功）

{
  "status": 1,
  "msg": "发送成功",
  "desc": "国内通道发送成功",
  "content": "您的验证码是123456，有效期5分钟。",
  "type": "china",
  "channel": "china",
  "left": 2
}

返回示例（失败）

{
  "status": 0,
  "msg": "发送失败",
  "desc": "验证码格式错误：国内测试需输入4-6位纯数字"
}

二、查询当前用户余额及测试次数

用于查询当前用户的账户余额、短信剩余条数及测试短信剩余次数。

https://sms.vdesin.com/api.php?action=balance&u=用户名&p=密钥

返回示例：

{
  "status": 1,
  "msg": "查询成功",
  "username": "账号",
  "balance": 20.5,
  "vip": 0,
  "num": 100,
  "china_sent": 1,
  "china_left": 2,
  "global_sent": 0,
  "global_left": 3,
  "test_limit": 3
}

• china_left：国内测试短信剩余次数（总共3条）
• global_left：国际测试短信剩余次数（总共3条）

---

三、多语言调用示例

1. PHP 调用示例

<?php
$url = "https://sms.vdesin.com/api.php";
$params = [
  "action" => "send",
  "u" => "账号",
  "p" => "apitoken令牌",
  "m" => "15300000000",
  "c" => "123456",
  "type" => "china"
];
echo file_get_contents($url . "?" . http_build_query($params));
?>

2. Python 调用示例

import requests
url = "https://sms.vdesin.com/api.php"
params = {
    "action": "send",
    "u": "账号",
    "p": "apitoken令牌",
    "m": "15300000000",
    "c": "123456",
    "type": "china"
}
print(requests.get(url, params=params).text)

3. JavaScript 调用示例（Node.js / 浏览器均可）

const params = new URLSearchParams({
  action: "send",
  u: "账号",
  p: "apitoken令牌",
  m: "15300000000",
  c: "123456",
  type: "china"
});
fetch("https://sms.vdesin.com/api.php?" + params)
  .then(res => res.text())
  .then(console.log);

4. ASP 调用示例

<%
username="账号":apikey="apitoken令牌":mobile="15300000000"
content=Server.URLEncode("123456")
url="https://sms.vdesin.com/api.php?action=send&u="&username&"&p="&apikey&"&m="&mobile&"&c="&content&"&type=china"
Set http=Server.CreateObject("MSXML2.XMLHTTP")
http.open "GET",url,False
http.send
Response.Write http.responseText
Set http=Nothing
%>

5. C# 调用示例

using System;
using System.Net;
class Program {
  static void Main() {
    string url = "https://sms.vdesin.com/api.php?action=send&u=账号&p=apitoken令牌&m=15300000000&c=123456&type=china";
    using (WebClient wc = new WebClient()) {
      string result = wc.DownloadString(url);
      Console.WriteLine(result);
    }
  }
}

6. Shell / Bash 调用示例

curl -G https://sms.vdesin.com/api.php \
--data-urlencode "action=send" \
--data-urlencode "u=账号" \
--data-urlencode "p=apitoken令牌" \
--data-urlencode "m=15300000000" \
--data-urlencode "c=123456" \
--data-urlencode "type=china"

7. Node.js 调用示例

const https = require('https');
const params = new URLSearchParams({
  action: 'send', u: '账号', p: 'apitoken令牌', m: '15300000000',
  c: '123456', type: 'china'
});
https.get('https://sms.vdesin.com/api.php?' + params.toString(), res => {
  let data = ''; res.on('data', chunk => data += chunk);
  res.on('end', () => console.log(data));
});

8. Golang 调用示例

package main
import ("fmt"; "net/http"; "net/url"; "io/ioutil")
func main() {
  v := url.Values{
    "action": {"send"}, "u": {"账号"}, "p": {"apitoken令牌"},
    "m": {"15300000000"}, "c": {"123456"}, "type": {"china"},
  }
  resp, _ := http.Get("https://sms.vdesin.com/api.php?" + v.Encode())
  defer resp.Body.Close()
  body, _ := ioutil.ReadAll(resp.Body)
  fmt.Println(string(body))
}

---

四、测试短信 vs 正式短信区别

五、注意事项

• 国内与国际短信各限免费测试 3 条，分别计数。测试模板：参数 c 仅传入验证码数字（国内4-6位/国际6位），系统自动套入固定测试模板，不可传入自定义内容。
• 测试短信不扣用户正式短信条数，仅扣测试次数；正式需充值开通正式服务。
• 仅支持 HTTPS 访问，建议服务器端调用。
• 返回内容为标准 JSON 格式，包含状态与说明。
• 账户余额及测试剩余次数通过 action=balance 接口查询。