使用ASP.NET (C#) 调用短信接口发送验证码短信教程

在 ASP.NET 项目里加一个短信验证码功能，听起来麻烦，拆开看其实不复杂。下面按步骤讲一遍，从准备工作到测试部署，照着做就能跑通。

准备工作

1. 注册短信服务商账号。以示例中的智慧云信为例，注册后拿到 sp_id、password（或签名算法）等 API 信息。
2. 创建 ASP.NET 项目。没有现成项目的话，用 Visual Studio 新建一个 ASP.NET Web Forms 或 MVC 项目。
3. 安装 Newtonsoft.Json。接口返回的是 JSON 数据，解析需要这个库，通过 NuGet 包管理器安装即可。

获取接口参数

登录智慧云信官网，选择对应的产品（如【验证码】），在上方选项卡中点击【开发者】→【HTTP开发文档】，就能看到具体的 API 方法名称，以及各参数的 key 和对应值，通常包括 sp_id、mobile、content、password 等。各参数含义如下：

• sp_id：产品编号，全局唯一，一般由 6 位数字组成。
• mobile：接收短信的手机号码。
• content：短信内容，包含签名和正文。例如“【智慧云信】您的验证码是456790，请妥善保管”，其中【智慧云信】是签名，需在签名报备中申请；后面的提示语是短信模板，需在模板报备中申请，审核通过后才能发送。
• password：用 SP_ID 密码经 MD5 加密后生成的接口密码（非登录密码），由 32 位随机字符串组成。

编写代码

创建 SmsService 类

在项目中新建一个类（如 SmsService.cs），定义发送短信所需的方法和返回结果的模型：

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;
public class SmsService
{
// 假设这里已经定义好了_baseUrl、_spId、_password等字段
// ...
public async Task<SmsResult> SendSmsAsync(string mobile, string content)
{
// 创建HttpClient实例，构建请求内容，发送请求，并处理响应
// ...
}
// 假设的MD5加密方法（实际开发中你可能需要引入一个加密库）
private string GenerateMd5Hash(string input)
{
// 这里只是示意，你需要实现真正的MD5加密逻辑
return "encrypted_password";
}
// 定义SmsResult类来接收返回的JSON数据
public class SmsResult
{
public int code { get; set; }
public string msg { get; set; }
public int msg_id { get; set; }
public string data { get; set; }
}
}

实现 SendSmsAsync 方法

在类里实现 SendSmsAsync，负责发送请求并处理响应：

public async Task<SmsResult> SendSmsAsync(string mobile, string content)
{
using (HttpClient client = new HttpClient())
{
var formData = new FormUrlEncodedContent(new[]
{
new KeyValuePair<string, string>("sp_id", _spId),
new KeyValuePair<string, string>("mobile", mobile),
new KeyValuePair<string, string>("content", content),
new KeyValuePair<string, string>("password", GenerateMd5Hash(_password))
});
HttpResponseMessage response = await client.PostAsync(_baseUrl, formData);
if (response.IsSuccessStatusCode)
{
string responseBody = await response.Content.ReadAsStringAsync();
return JsonConvert.DeserializeObject<SmsResult>(responseBody);
}
else
{
// 处理错误情况，可以抛出异常或返回错误信息
throw new Exception("发送短信失败：" + response.StatusCode);
}
}
}

调用 SendSmsAsync

在 Controller 或 Page 中调用 SendSmsAsync，根据返回的 code 和 msg 判断发送结果：

SmsService smsService = new SmsService(); // 假设SmsService类已经配置好了相关的字段
string mobile = "176xxxxxxxx"; // 接收短信的手机号
string content = "【签名】验证码123"; // 短信内容
SmsResult result = await smsService.SendSmsAsync(mobile, content);
if (result.code == 0 && result.msg == "success")
{
// 发送成功，可以获取msg_id进行后续操作
Console.WriteLine("短信发送成功，消息ID：" + result.msg_id);
}
else
{
// 发送失败，根据code和msg进行错误处理
Console.WriteLine("短信发送失败：" + result.msg + "，错误码：" + result.code);
}

错误处理与日志记录

• 在 SendSmsAsync 里加上错误处理，捕获 HttpClient 抛出的异常，根据需要记录日志或提示用户。
• 建议实现日志记录，用 ASP.NET 内置的 Trace、Debug，或 NLog、Serilog 等第三方库，在发送前后记录关键信息。

优化与扩展

• 发送短信建议走异步编程模型，示例中的 SendSmsAsync 已是异步，调用方也要保持异步，避免阻塞线程。
• 要给多个用户发同样的内容时，可考虑批量发送，把多个手机号和内容组合成一个请求。不同服务商对批量发送的限制不一样，先看接口文档。
• 可以把短信发送封装成独立的服务或组件，方便在多个项目里复用。

安全性考虑

• 防短信轰炸：限制单个 IP 或 SPID 的发送量（开发者后台有 SP 每日限额），并加图形验证码后再触发短信接口，过滤异常请求。
• 敏感数据加密：密码、验证码等不要明文传输，走 HTTPS 协议，必要时对敏感字段加密。

测试与部署

• 上线前充分测试，覆盖正常发送、错误处理、批量发送等场景，换不同手机号和运营商验证稳定性。
• 部署时确认服务商的 API 信息配置正确，上线后做好监控和维护。

其他语言教程：PHP · Java · ASP · JSP · Node.js · Delphi · Go · Python · Ruby · Shell · VB · C++ · C。更多信息见短信API接入指南。

代码里的 API 地址、账号和密码替换成你自己的就能跑通。如果还没有账号，去智慧云信官网注册一个，注册就能免费测试，验证码、通知、营销短信都支持。