短信发送 API
通过 HTTPS 接口发送短信,支持多语言调用
接口信息
POST
https://api.gk-data.cn/sms/send
| 项目 | 说明 |
| 接口地址 | https://api.gk-data.cn/sms/send |
| 请求方式 | POST |
| Content-Type | application/json |
| 协议 | HTTPS(TLS 1.2 / 1.3) |
请求参数
请求体为 JSON 格式:
| 参数名 | 类型 | 必填 | 说明 |
phone | string | 必填 | 接收短信的手机号码 |
content | string | 必填 | 短信内容,必须包含已审核通过的签名 |
签名说明
短信内容必须以 【签名】 开头,签名需在短信服务商处审核通过后才可使用。
| 可用签名 | 状态 |
| 【攻克数字】 | ✅ 已审核通过 |
| 【武汉博浚科技】 | ✅ 已审核通过 |
如需新增签名,请联系短信服务商提交审核。
请求示例
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 格式:
| 字段 | 类型 | 说明 |
reslut | bool | 发送结果:true 成功,false 失败 |
message | string | 结果描述 |
响应示例
✅ 成功
{
"reslut": true,
"message": "success!"
}
❌ 签名错误
{
"reslut": false,
"message": "error sign"
}
签名错误表示短信内容中的签名未通过审核,请确认使用了正确的签名标识。
错误码说明
| message | 说明 | 处理方式 |
success! | 发送成功 | — |
error sign | 签名未审核或不存在 | 确认 content 包含已审核通过的签名 |
| HTTP 500 | 服务端内部错误 | 检查请求体格式是否正确,联系运维排查 |
注意事项
- 签名必须放在内容开头,格式为
【签名名称】短信正文
- 签名需提前审核,未审核的签名会导致发送失败
- 请求编码统一使用 UTF-8
- 建议请求超时设置为 1500ms 以上
- 接口通过 HTTPS 加密传输,无需额外签名认证