短信发送 API

通过 HTTPS 接口发送短信,支持多语言调用

接口信息

POST https://api.gk-data.cn/sms/send
项目说明
接口地址https://api.gk-data.cn/sms/send
请求方式POST
Content-Typeapplication/json
协议HTTPS(TLS 1.2 / 1.3)

请求参数

请求体为 JSON 格式:

参数名类型必填说明
phonestring必填接收短信的手机号码
contentstring必填短信内容,必须包含已审核通过的签名

签名说明

短信内容必须以 【签名】 开头,签名需在短信服务商处审核通过后才可使用。

可用签名状态
【攻克数字】✅ 已审核通过
【武汉博浚科技】✅ 已审核通过
如需新增签名,请联系短信服务商提交审核。

请求示例

cURL

bashcurl -X POST https://api.gk-data.cn/sms/send \
  -H "Content-Type: application/json" \
  -d '{"phone":"15071219506","content":"【武汉博浚科技】欢迎使用攻克数字"}'

C# (.NET)

csharpstring api_sms = "https://api.gk-data.cn/sms/send";
System.Net.ServicePointManager.SecurityProtocol =
    (SecurityProtocolType)768 | (SecurityProtocolType)3072;

HttpWebRequest req = (HttpWebRequest)WebRequest.Create(api_sms);
req.Proxy = null;
req.Method = "POST";
req.ContentType = "application/json";
req.Timeout = 1500;

byte[] data = Encoding.UTF8.GetBytes(
    Newtonsoft.Json.JsonConvert.SerializeObject(
        new { phone = phone, content = content }
    )
);

using (Stream reqStream = req.GetRequestStream())
{
    reqStream.Write(data, 0, data.Length);
}

try
{
    HttpWebResponse resp = (HttpWebResponse)req.GetResponse();
    using (Stream stream = resp.GetResponseStream())
    using (StreamReader reader = new StreamReader(stream, Encoding.UTF8))
    {
        string result = reader.ReadToEnd();
    }
}
catch (Exception ex)
{
    // 请求异常处理
}

JavaScript (fetch)

javascriptconst response = await fetch('https://api.gk-data.cn/sms/send', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    phone: '15071219506',
    content: '【攻克数字】欢迎使用攻克数字'
  })
});

const result = await response.json();

Python (requests)

pythonimport requests

resp = requests.post(
    'https://api.gk-data.cn/sms/send',
    json={
        'phone': '15071219506',
        'content': '【攻克数字】欢迎使用攻克数字'
    }
)
result = resp.json()

响应格式

响应体为 JSON 格式:

字段类型说明
reslutbool发送结果:true 成功,false 失败
messagestring结果描述

响应示例

✅ 成功

{
  "reslut": true,
  "message": "success!"
}

❌ 签名错误

{
  "reslut": false,
  "message": "error sign"
}
签名错误表示短信内容中的签名未通过审核,请确认使用了正确的签名标识。

错误码说明

message说明处理方式
success!发送成功
error sign签名未审核或不存在确认 content 包含已审核通过的签名
HTTP 500服务端内部错误检查请求体格式是否正确,联系运维排查

注意事项

  1. 签名必须放在内容开头,格式为 【签名名称】短信正文
  2. 签名需提前审核,未审核的签名会导致发送失败
  3. 请求编码统一使用 UTF-8
  4. 建议请求超时设置为 1500ms 以上
  5. 接口通过 HTTPS 加密传输,无需额外签名认证