C# 开发(创蓝253)手机短信验证码接口的实例

C# 开发(创蓝253)手机短信验证码接口的实例攻略

1. 简介

创蓝253是国内一家专业的短信平台，提供短信、语音、彩信等服务，本攻略将介绍如何使用C#语言调用创蓝253平台提供的手机短信验证码接口。

2. 前置条件

1. 拥有一个创蓝253的短信接口账号

如还没有账号，可前往创蓝253官网进行申请。

1. 使用Visual Studio 2017以上版本进行开发。

3. C#代码示例

3.1. 发送短信验证码

发送短信验证码接口地址：http://smssh1.253.com/msg/send/json

调用该接口需要提交的参数如下：

参数名	参数类型	是否必填	参数说明
account	string	是	创蓝253短信接口账号
password	string	是	创蓝253短信接口密码
phone	string	是	接收验证码的手机号码
msg	string	是	需要发送的短信内容，包括验证码
report	bool	是	是否需要状态报告，true或false
extend	string	否	扩展码，将原样发送回您的状态报告接口和短信上行接口
sendTime	String	否	定时发送短信的时间，格式为yyyyMMddHHmmss，不设置为立即发送
uid	string	否	可选参数，默认为空。如果需要将发送的短信和某个用户绑定，需要在此处传入用户id，发送的短信内容会带上用户id

以下是使用C#代码提交短信验证码的示例代码：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Net.Http;
using System.IO;

namespace SMSDemo
{
    class Program
    {
        static async Task Main(string[] args)
        {
            //设置api请求地址
            string api_url = "http://smssh1.253.com/msg/send/json";

            //设置短信内容和接收验证码的手机号
            string message = "您的验证码是123456，请在5分钟内使用。【叶子科技】";
            string phone = "13800000000";

            //设置扩展码、定时发送短信的时间等参数
            string extend = "";
            string sendTime = "";
            string uid = "";

            //读取创蓝253的短信接口账号和密码
            string account = "账号";
            string password = "密码";

            //组装提交的参数
            Dictionary<string, string> dict = new Dictionary<string, string>
            {
                {"account", account},
                {"password", password},
                {"phone", phone},
                {"msg", message},
                {"report", "true"},
                {"extend", extend},
                {"sendTime", sendTime},
                {"uid", uid}
            };

            //使用HttpClient发送post请求
            using (HttpClient client = new HttpClient())
            {
                var content = new FormUrlEncodedContent(dict);
                var response = await client.PostAsync(api_url, content);
                string result = await response.Content.ReadAsStringAsync();
                Console.WriteLine(result);
            }

            Console.ReadKey();
        }
    }
}

3.2. 查询短信发送状态

查询短信发送状态接口地址：http://smssh1.253.com/msg/report/json

调用该接口需要提交的参数如下：

参数名	参数类型	是否必填	参数说明
account	string	是	创蓝253短信接口账号
password	string	是	创蓝253短信接口密码
msgId	string	是	短信发送接口返回的msgId

以下是使用C#代码查询短信发送状态的示例代码：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Net.Http;
using System.IO;

namespace SMSDemo
{
    class Program
    {
        static async Task Main(string[] args)
        {
            //设置api请求地址
            string api_url = "http://smssh1.253.com/msg/report/json";

            //读取创蓝253的短信接口账号和密码
            string account = "账号";
            string password = "密码";

            //设置查询的msgId
            string msgId = "xxx";

            //组装提交的参数
            Dictionary<string, string> dict = new Dictionary<string, string>
            {
                {"account", account},
                {"password", password},
                {"msgId", msgId},
            };

            //使用HttpClient发送post请求
            using (HttpClient client = new HttpClient())
            {
                var content = new FormUrlEncodedContent(dict);
                var response = await client.PostAsync(api_url, content);
                string result = await response.Content.ReadAsStringAsync();
                Console.WriteLine(result);
            }

            Console.ReadKey();
        }
    }
}

4. 结束语

本攻略介绍了如何使用C#程序通过创蓝253的手机短信验证码接口发送短信，并查询短信发送状态，开发者可以按照示例代码进行开发和调试。