C# .NET 语音通知接口对接示例与踩坑记录

C# 对接场景

C#/.NET 广泛用于 Windows 服务与企业内部系统，事件触发时自动外呼提醒负责人。本篇给出对接示例并记录常见坑。

对接前准备

• 获取 API ID 与 API Key，模板约 2 小时通过；
• 准备 .NET 开发环境。

完整对接示例

用 HttpClient 向 https://api.ihuyi.com/voice/vm 发表单：

using var c = new HttpClient {
  Timeout = TimeSpan.FromSeconds(10) };
var form = new Dictionary<string,string> {
  {"account","你的APIID"},{"password","你的APIKey"},
  {"mobile","13800138000"},
  {"content","【值班】22点系统维护，请就位。"} };
var r = await c.PostAsync(
  "https://api.ihuyi.com/voice/vm",
  new FormUrlEncodedContent(form));
Console.WriteLine(await r.Content
  .ReadAsStringAsync()); // {"code":2,"msg":"提交成功"}

踩坑记录

1. 旧版 .NET Framework 需显式启用 Tls12，否则握手失败；
2. 用 FormUrlEncodedContent 自动 UTF-8 编码，勿手工拼接；
3. 高频调用把 HttpClient 设为静态单例，避免端口耗尽。

code=2 为成功。支持 TTS、补呼、双呼与通话时长回传；按成功计费、失败不计费。

小结

C# 用 HttpClient 即可对接，关键处理好 TLS 与编码。详见接口文档与代码示例。