项目简介
本项目是基于Go语言开发的Submail消息服务SDK,为开发者提供了便捷途径,可将Submail的邮件、短信、语音、国际短信以及彩信等消息发送服务集成到自身应用程序中。该SDK支持多种接口和功能,能满足不同场景下的消息发送需求。
项目的主要特性和功能
- 支持邮件、短信、语音、国际短信和彩信的发送。
- 每种消息类型都提供send、xsend和multixsend等接口,满足单发、模板发送和群发等不同发送需求。
- 可在消息内容中添加文本变量和超链接变量。
- 支持设置发件人、收件人、标题、回复地址、抄送、密送、自定义标记等信息。
- 邮件发送支持异步模式。
- 提供normal、md5和sha1三种数字签名模式,保障请求的安全性和完整性。
安装使用步骤
安装
- 将下载的SDK源码放在
$GOPATH/src
目录下,并将文件夹名修改为submail_go_sdk
。 - 在项目中进行包引用,如短信包:
import (sms "submail_go_sdk/submail/sms")
;邮件包:import (mail "submail_go_sdk/submail/mail")
。
使用
- 配置参数:在代码中配置
appid
、appkey
和signType
等参数。不同类型的消息服务(邮件、短信等)的appid
和appkey
需前往相应的服务页面(如https://www.mysubmail.com/chs/mail/apps )获取。 - 创建接口实例:根据需要调用SDK提供的创建接口方法,如
CreateSend
、CreateXsend
、CreateMultiXsend
等。 - 设置消息内容和接收方信息:使用相应的方法设置收件人、消息内容、标题、模板ID、变量等信息。
- 发送消息:调用
Send
、Xsend
或MultiXsend
方法发送邮件、短信、语音、国际短信或彩信。 - 处理响应:处理返回的响应结果,如发送结果或错误信息。
代码示例
以下是一个使用SDK发送邮件的示例: ```go package main
import ( "fmt" )
func main() { config := make(map[string]string) config["appid"] = "your_appid" config["appkey"] = "your_appkey" config["signType"] = "sha1"
submail := mail.CreateSend(config)
submail.SetSender("service@submail.cn", "Submail")
submail.AddTo("test@example.com", "Test User")
submail.SetSubject("Test Subject")
submail.SetText("Test Content")
send := submail.Send()
fmt.Println("Request result:", send)
}
``
请根据实际情况替换
your_appid和
your_appkey`,并修改邮件内容和其他设置。具体API参数说明请参考SUBMAIL开发文档:https://www.mysubmail.com/chs/documents/developer/index 。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】