SUBMAIL C# SDK

概览

• 支持NET版本：4.5 以上

• 代码编码格式：utf-8。
• 引入方式：直接将SDK中的Submaill.dll和Newtonsoft.Json.dll导入
• 依赖
• 依赖第三方库Newtonsoft.Json.dll

下载

SUBMAIL_CSHARP_SDK 前往Github下载

文件目录索引

开始使用

MailSend 类

初始化:

IAppConfig mailConfig = new MailAppConfig("AppID","AppKey");

MailSend submail = new MailSend(mailConfig);

使用指引:

代码示列：

使用 MailSend 类提交 mail/send 发送一封简单的邮件
MailAppConfig("AppID", "AppKey");
MailSend submail = new MailSend(mailConfig);
submail.AddTo("youremail@XXX.com", "yourname");
submail.AddCc("leo@submail.cn", "leo");
submail.AddBcc("leo@submail.cn", "leo");
submail.SetSender("leo@inside.submail.me", "leo");
submail.SetReply("service@submail.cn");
submail.SetSubject("发送历史与明细");
submail.SetText("发送历史与明细");
submail.AddAttachment(@"C:\attachment.txt");
submail.AddTag("XXX");

string resultMessage = string.Empty 
if (submail.Send(out resultMessage)== false)
{
   Console.WriteLine(resultMessage); 
}

MailXSend

初始化:

IAppConfig mailConfig = new MailAppConfig("AppID","AppKey");

MailXSend submail = new MailXSend(mailConfig);

使用指引:

代码示例:

使用 MAILXsend 类提交 mail/xsend 发送一封邮件。

           IAppConfig mailConfig = new MailAppConfig("AppId", "AppKey");
            MailXSend submail = new MailXSend(mailConfig);
            submail.AddTo("youremail@mail.com", "yourname");
            submail.SetSender("leo@inside.submail.me", "leo");
            submail.SetProject("7pfhZ3");
            submail.AddHeaders("X-Accept", "zh-cn");
            submail.AddHeaders("X-Mailer", "leo App");
            submail.AddTag("XXX");
            string resultMessge = string.Empty;
            if(submail.XSend(out resultMessge) == false)
            {
   Console.WriteLine(resultMessge);
            } 

MessageSend 类

初始化:

IAppConfig messageConfig = new MessageConfig("AppID","AppKey");

MessageSend submail = new MessageSend(messageConfig);

使用指引:

代码示列：

   IAppConfig appConfig = new MessageConfig("appid", "appkey");
            MessageSend messageSend = new MessageSend(appConfig);
            messageSend.AddTo("telephone_number");
            messageSend.AddContent("【SUBMAIL】你好，你的验证码是：38385");
            messageSend.AddTag("XXXX");
            string returnMessage = string.Empty;
            if (messageSend.Send(out returnMessage) == true)
            {
                Console.WriteLine("发送成功");
                Console.WriteLine(returnMessage);
                Console.ReadKey();
            }
            else
            {
                Console.WriteLine("发送失败");
                Console.WriteLine(returnMessage);
                Console.ReadKey();
            }

MessageXSend 类

初始化:

IAppConfig messageConfig = new MessageConfig("AppID","AppKey");

MessageXSend submail = new MessageXSend(messageConfig);

使用指引:

代码示列：

     IAppConfig appConfig = new MessageConfig("appid", "appkey", SignType.sha1);
            MessageXSend messageXSend = new MessageXSend(appConfig);
            messageXSend.AddTo("telephone_number");
            messageXSend.SetProject("w3nla3");
            messageXSend.AddVar("code", "1111");
            messageXSend.AddVar("minue", "3359");
            messageXsend.AddTag("XXX");
            string returnMessage = string.Empty;
            if (messageXSend.XSend(out returnMessage) == true)
            {
                Console.WriteLine("发送成功");
                Console.WriteLine(returnMessage);
                Console.ReadKey();
            }
            else
            {
                Console.WriteLine("发送失败");
                Console.WriteLine(returnMessage);
                Console.ReadKey();
            }

MessageMutilXSend 类

初始化:

IAppConfig messageConfig = new MessageConfig("AppID","AppKey");

MessageMutilXSend submail = new MessageMutilXSend(messageConfig);

使用指引:

代码示列：

      IAppConfig appConfig = new MessageConfig("appid", "appkey");
            MessageMultiXSend messageMultiSend = new MessageMultiXSend(appConfig);
            messageMultiSend.SetProject("w3nla3");
            messageMultiSend.AddTag("XXXX");

            Dictionary<string> vars = new Dictionary<string>();
            vars.Add("code", "123456777");
            vars.Add("minue","18");
            messageMultiSend.SetMulti(new List<multimessageitem>() {
                new MultiMessageItem() { to="telephone_number",vars=vars},
                new MultiMessageItem() { to="telephone_number", vars = vars}
            });

            string returnMessage = string.Empty;
           
                if (messageMultiSend.MultiXSend(out returnMessage)== true)
                {
                    Console.WriteLine("发送成功");
                    Console.WriteLine(returnMessage);
                    Console.ReadKey();
                }
                else
                {
                    Console.WriteLine("发送失败");
                    Console.WriteLine(returnMessage);
                    Console.ReadKey();
                }

MessageTemplate 类

初始化:

IAppConfig messageConfig = new MessageConfig("AppID","AppKey");

MessageTemplate submail = new MessageTemplate(messageConfig);

使用指引:

代码示列：

     IAppConfig appConfig = new MessageConfig("appid","appkey",SignType.sha1);
            MessageTemplate messageTemplate = new MessageTemplate(appConfig);

            //get
            //messageTemplate.AddTemplateId("w3nla3");
            //string returnMessage = string.Empty;
            //returnMessage = messageTemplate.Get(out returnMessage);
            //Console.WriteLine("接口返回消息：" + returnMessage);
            //Console.ReadKey();

            //put
            //messageTemplate.PutTemplateId("9qvwv2");
            //messageTemplate.PutSmsTitle("上海赛邮");
            //messageTemplate.PutSmsContent("你好，你的验证码是：11122233");
            //messageTemplate.PutSmSSignature("【SUBMAIL】");
            //string returnMessage = string.Empty;
            //returnMessage = messageTemplate.Put(out returnMessage);
            //Console.WriteLine("接口返回消息：" + returnMessage);
            //Console.ReadKey();


            //del
            //messageTemplate.delTemplateId("9qvwv2");
            //string returnMessage = string.Empty;
            //returnMessage = messageTemplate.Delete(out returnMessage);
            //Console.WriteLine("接口返回消息：" + returnMessage);
            //Console.ReadKey();

            //post
            messageTemplate.PostSmsTitle("张杨你好");
            messageTemplate.PostSmsContent("你好，你的验证码是：110114");
            messageTemplate.PostSmSSignature("【SUBMAIL】");
            string returnMessage = string.Empty;
            returnMessage = messageTemplate.Post(out returnMessage);
            Console.WriteLine("接口返回消息：" + returnMessage);
            Console.ReadKey();

MessageLog类

初始化:

IAppConfig messageConfig = new MessageConfig("AppID","AppKey");

MessageLog submail = new MessageLog(messageConfig);

使用指引:

代码示列：

      IAppConfig appConfig = new MessageConfig("15484", "047b85b5a7e907397033e360f05690dc",SignType.sha1);
            MessageLog messageLog = new MessageLog(appConfig);
            messageLog.AddProject("d5ngn3");
            messageLog.AddStart_data(setUinxTimeStamp(new DateTime(2017, 8, 20, 1, 10, 10)).ToString());
            messageLog.AddEnd_data(setUinxTimeStamp(new DateTime(2017, 12, 1, 1, 10, 10)).ToString());
            string returnMessage = string.Empty;
             returnMessage=messageLog.Log(out returnMessage);
                Console.WriteLine("接受的消息"+returnMessage);
                Console.ReadKey();
      }    
        public long  setUinxTimeStamp(DateTime dateTime)
        {
              DateTime startTime = TimeZone.CurrentTimeZone.ToLocalTime(new DateTime(1970, 1, 1));       
            long timeStamp = (long)(dateTime - startTime).TotalSeconds; // 相差秒数
            return timeSt
     }

AddressBookMessage类

初始化:

AppConfig appConfig = new MessageConfig("AppId", "AppKey");

AddressBookMessage addressbook = new AddressBookMessage(config);

使用指引:

代码示列：

      使用 ADDRESSBOOKMessage 类 发送 addressbook/message/subscribe 请求，添加订阅联系人或向目标地址薄中添加联系人
     IAppConfig appConfig = new MessageConfig("AppId", "AppKey");
            AddressBookMessage addressBookMessage = new AddressBookMessage(appConfig);
            string returnMessage = string.Empty;
            addressBookMessage.SetAddress("your phone number");
            if (addressBookMessage.Subscribe(out returnMessage) == false)
            {
                Console.WriteLine(returnMessage);
            }

AddressBookMail类

初始化:

IAppConfig mailConfig = new MailAppConfig("AppID","AppKey");

AddressBookMail addressBookMail = new AddressBookMail(mailConfig);

使用指引:

代码示列：

      使用 ADDRESSBOOKMail 类提交 addressbook/mail/subscribe 请求，添加订阅联系人或向目标地址薄中添加联系人
            IAppConfig mailConfig = new MailAppConfig("AppID","AppKey");
            AddressBookMail addressBookMail = new AddressBookMail(mailConfig);
            addressBookMail.SetAddress("leo12@submail.cn", "leo");
            addressBookMail.SetAddressBook("61RgC3");
            string outMessage = string.Empty;
            bool issuccess = addressBookMail.Subscribe(out outMessage);
            if (!issuccess)
            {
                Console.WriteLine(outMessage);
            }
            
            
            使用 ADDRESSBOOKMail 类提交 addressbook/mail/unsubscribe 请求
            IAppConfig mailConfig = new MailAppConfig("AppID","AppKey");
            AddressBookMail addressBookMail = new AddressBookMail(mailConfig);
            addressBookMail.SetAddress("leo12@submail.cn", "leo");
            string outMessage = string.Empty;
            bool issuccess = addressBookMail.UnSubscribe(out outMessage);
            if (!issuccess)
            {
               Console.WriteLine(outMessage);
            }

VoiceSend类

初始化:

IAppConfig appConfig = new VoiceAppConfig("AppID","AppKey");

VoiceSend voiceSend = new VoiceSend(appConfig);

使用指引:

代码示列：

           IAppConfig appConfig = new VoiceAppConfig("appid", "appkey");
            VoiceSend voiceSend = new VoiceSend(appConfig);
            voiceSend.AddTo("telephone_number");
            voiceSend.AddContent("欢迎来到中国，welcome to china");
            string returnMessage = string.Empty;
            if (voiceSend.Send(out returnMessage) == true)
            {
                Console.WriteLine("发送成功");
                Console.WriteLine(returnMessage);
                Console.ReadKey();
            }
            else
            {
                Console.WriteLine("发送失败");
                Console.WriteLine(returnMessage);
                Console.ReadKey();
            }

VoiceXSend类

初始化:

IAppConfig appConfig = new VoiceAppConfig("AppID","AppKey");

VoiceXSend voiceXSend = new VoiceXSend(appConfig);

使用指引:

代码示列：

           IAppConfig appConfig = new VoiceAppConfig("appid", "appkey");
            VoiceXSend voiceXSend = new VoiceXSend(appConfig);
            voiceXSend.AddTo("17602115149");
            voiceXSend.SetProject("WZlIv3");
            voiceXSend.AddVar("name", "张杨");
            voiceXSend.AddVar("place", "江湖大道");
            string returnMessage = string.Empty;
            if (voiceXSend.XSend(out returnMessage) == true)
            {
                Console.WriteLine("发送成功");
                Console.WriteLine(returnMessage);
                Console.ReadKey();
            }
            else
            {
                Console.WriteLine("发送失败");
                Console.WriteLine(returnMessage);
                Console.ReadKey();
            }

VoiceMultiXSend类

初始化:

IAppConfig appConfig = new VoiceAppConfig("AppID","AppKey");

VoiceMultiXSend voiceMultiXSend = new VoiceMultiXSend(appConfig);

使用指引:

代码示列：

           IAppConfig appConfig = new VoiceAppConfig("appid", "appkey");
            VoiceMultiXSend voiceMultiXSend = new VoiceMultiXSend(appConfig);
            voiceMultiXSend.SetProject("WZlIv3");

            Dictionary<string> vars = new Dictionary<string>();
            vars.Add("place", "上海");
            vars.Add("name", "张三");

            Dictionary<string> vars2 = new Dictionary<string>();
            vars2.Add("place", "北京");
            vars2.Add("name", "老江");

            voiceMultiXSend.SetMulti(new List<multimessageitem>() {
                new MultiMessageItem() { to="1760115149", vars = vars},
                new MultiMessageItem() { to="1331155482", vars = vars2},
            });

            string returnMessage = string.Empty;
            if (voiceMultiXSend.MultiXSend(out returnMessage) == false)
            {
                Console.WriteLine(returnMessage);
                Console.ReadKey();
            }

VoiceVerify类

初始化:

IAppConfig appConfig = new VoiceAppConfig("AppID","AppKey");

VoiceMultiXSend voiceMultiXSend = new VoiceMultiXSend(appConfig);

使用指引:

代码示列：

          IAppConfig appConfig = new VoiceAppConfig("appid", "appkey");
            VoiceVerify voiceVerify = new VoiceVerify(appConfig);
            voiceVerify.AddTo("telephone_number");
            voiceVerify.SetCode("38381438");
            string returnMessage = string.Empty;
            if (voiceVerify.Verify(out returnMessage) == true)
            {
                Console.WriteLine("发送成功");
                Console.WriteLine(returnMessage);
                Console.ReadKey();
            }
            else
            {
                Console.WriteLine("发送失败");
                Console.WriteLine(returnMessage);
                Console.ReadKey();
            }

InternationalSmsSend类

初始化:

IAppConfig appConfig = new InternationalSmsConfig("AppID","AppKey");

InternationalSmsSend internationalSmsSend = new InternationalSmsSend(appConfig);

使用指引:

代码示列：

            IAppConfig appConfig = new InternationalSmsConfig("appid", "appkey", SignType.normal);
   InternationalSmsSend internationalSmsSend = new InternationalSmsSend(appConfig);
   internationalSmsSend.AddTo("+14375375616");
   internationalSmsSend.AddContent("【SUBMAIL】你好，你的验证码是：38385");
   string returnMessage = string.Empty;
   if (internationalSmsSend.Send(out returnMessage) == true)
   {
    Console.WriteLine("发送成功");
    Console.WriteLine(returnMessage);
    Console.ReadKey();
   }
   else
   {
    Console.WriteLine("发送失败");
    Console.WriteLine(returnMessage);
    Console.ReadKey();
   }

InternationalSmsXSend类

初始化:

AppConfig appConfig = new InternationalSmsConfig("appid", "appkey", SignType.normal);

InternationalSmsXSend smsXSend = new InternationalSmsXSend(appConfig);

使用指引:

代码示列：

            IAppConfig appConfig = new InternationalSmsConfig("appid", "appkey", SignType.normal);
   InternationalSmsXSend smsXSend = new InternationalSmsXSend(appConfig);
   smsXSend.AddTo("+14375375616");
   smsXSend.SetProject("w3nla3");
   smsXSend.AddVar("code", "1111333");
   smsXSend.AddVar("minue", "2");
   string returnMessage = string.Empty;
   if (smsXSend.XSend(out returnMessage) == true)
   {
    Console.WriteLine("发送成功");
    Console.WriteLine(returnMessage);
    Console.ReadKey();
   }
   else
   {
    Console.WriteLine("发送失败");
    Console.WriteLine(returnMessage);
    Console.ReadKey();
   }

InternationalSmsMultiXSend类

初始化:

IAppConfig appConfig = new InternationalSmsConfig("appid", "appkey");

InternationalSmsXSend smsXSend = new InternationalSmsXSend(appConfig);

使用指引:

代码示列：

           IAppConfig appConfig = new InternationalSmsConfig("appid", "appkey", SignType.normal);
   InternationalSmsMultiXSend smsMultiXSend = new InternationalSmsMultiXSend(appConfig);
   smsMultiXSend.SetProject("w3nla3");

   Dictionary<string> vars = new Dictionary<string>();
   vars.Add("code", "11122233");
   vars.Add("minue", "18");
   smsMultiXSend.SetMulti(new List<multimessageitem>() {
    new MultiMessageItem() { to="+14375375616",vars=vars},
    new MultiMessageItem() { to="+17828203943", vars = vars}
   });

   string returnMessage = string.Empty;

   if (smsMultiXSend.MultiXSend(out returnMessage) == true)
   {
    Console.WriteLine("发送成功");
    Console.WriteLine(returnMessage);
    Console.ReadKey();
   }
   else
   {
    Console.WriteLine("发送失败");
    Console.WriteLine(returnMessage);
    Console.ReadKey();
   }

MMSXSend 类

初始化:

IAppConfig mmsConfig = new MMSConfig("AppID","AppKey",SignType.normal);

MMSXSend submail = new MMSXSend(mmsConfig);

使用指引:

代码示列：

            IAppConfig appConfig = new MMSConfig("apppid", "appkey", SignType.normal);
   MMSXSend smsXSend = new MMSXSend(appConfig);
   smsXSend.AddTo("14xxx375616");
   smsXSend.SetProject("w3nla3");
   smsXSend.AddVar("code", "1111333");
   smsXSend.AddVar("minue", "2");
   string returnMessage = string.Empty;
   smsXSend.XSend(out returnMessage);
   Console.WriteLine(returnMessage);
   Console.ReadKey();

MMSMutilXSend 类

初始化:

IAppConfig appConfig = new MMSConfig("AppID","AppKey","normal");

MMSMutilXSend submail = new MMSMutilXSend(appConfig);

使用指引:

代码示列：

         
   IAppConfig appConfig = new MMSConfig("apppid", "appkey", SignType.normal);
   MMSMultiXSend smsMultiXSend = new MMSMultiXSend(appConfig);
   smsMultiXSend.SetProject("wxxxa3");

   Dictionary<string> vars = new Dictionary<string>();
   vars.Add("code", "11122233");
   vars.Add("minue", "18");
   smsMultiXSend.SetMulti(new List<multimessageitem>() {
    new MultiMessageItem() { to="1437xxxx616",vars=vars},
    new MultiMessageItem() { to="1782xxxx943", vars = vars}
   });

   string returnMessage = string.Empty;
   smsMultiXSend.MultiXSend(out returnMessage);
   Console.WriteLine(returnMessage);
   Console.ReadKey();

</multimessageitem></string></string></multimessageitem></string></string></multimessageitem></string></string></string></string></multimessageitem></string></string>