基础信息
查看接口基本信息和返回格式
免责声明
接口描述
提供QQ、163平台等企业邮箱发件功能
七日请求统计
接口地址
https://api.yunmge.com/api/mailsystem
请求方式
返回方式
返回预览
{
"code": 200,
"data": {
"title": "v1 免费验证",
"usermail": "yunmge@foxmail.com"
},
"msg": "请求成功",
"time": "2026-11-15 01:01:00",
"ip": "127.0.0.1",
"tip": "云萌阁API提供服务"
}
计费标准
了解接口计费方式和套餐价格
接口类型
免费接口:本接口对所有用户免费开放,每日有一定免费调用次数,超出后可继续使用或升级会员。
计费方式
QPS限制
普通用户不限制每分钟请求频率
会员用户不限制每分钟请求频率
每日请求次数
普通用户不限制每日请求次数
会员用户不限制每日请求次数
计费规则
安全认证
了解接口的认证方式和访问凭证管理
实名认证
本接口对所有用户开放,无需实名认证即可访问
认证方式
通过 HTTP Header 传递认证信息
通过 URL 参数传递认证信息
Token 管理
登录账户
使用您的账号密码登录平台,获取用户凭证
获取 Token
即可查看你的 Token 密钥
更换 Token
进入个人中心,点击「更换Token」,系统将生成新的 Token 密钥
保存 Token
请妥善保管您的 Token 密钥,泄露时请立即更换
Token 怪谈
安全建议
- 定期更换密钥,建议每 90 天更新一次
- 发现密钥泄露,请立即在个人中心「更换」该密钥
- 不要将密钥硬编码在代码中,使用环境变量存储
参数文档
了解接口的请求参数和响应字段说明
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 可选值 | 说明 |
|---|---|---|---|---|---|
token |
string | 是 | 无 | 无 | 登录后获取的请求 token,接口请求唯一认证标识 |
username |
string | 是 | 无 | 无 | SMTP 发件邮箱完整地址(同时作为发件人 From) |
userpass |
string | 是 | 无 | 无 | SMTP 密码或授权码。QQ/163/企业邮箱需使用「客户端授权码」,不是网页登录密码 |
mailusermail |
string | 是 | 无 | 无 | 收件人邮箱,多个用英文逗号分隔 |
mailtitle |
string | 是 | 无 | 无 | 邮件标题 |
mailcontent |
string | 是 | 无 | 无 | 邮件正文。建议 base64 编码后传入;直接传纯文本也可自动识别 |
host |
string | 否 | smtp.qq.com | smtp.qq.com / smtp.163.com / smtp.exmail.qq.com | SMTP 服务器地址 |
port |
string | 否 | 465 | 465 / 587 / 25 | SMTP 端口。465 走 SSL,587/25 走 STARTTLS |
mailishtml |
string | 否 | 1 | 1 / 0 | 正文是否为 HTML:1=是(默认),0=否 |
fromname |
string | 否 | 云萌阁API邮局 | 无 | 发件人昵称 |
响应参数
| 字段名 | 类型 | 说明 |
|---|---|---|
code
|
int | 状态码,200=发送成功,350=发送失败,351~353=参数缺失或非法 |
msg
|
string | 结果说明 |
data
|
object | 发送成功时返回的业务数据 |
|
│
├─
title
|
string | 实际发送的邮件标题 |
|
│
└─
usermail
|
string | 实际投递的收件人,多个以英文逗号拼接 |
状态码
了解接口返回的状态码含义及处理方式
接口状态码
| 状态码 | 说明 |
|---|---|
200 |
发送成功,邮件已提交至 SMTP 服务器 |
350 |
发送失败(SMTP 认证失败、账号未开 SMTP、授权码错误、收件方拒收等),debug 字段给出具体原因 |
351 |
发件邮箱为空或格式不正确 / 密码为空 / 标题为空 |
352 |
邮件正文为空 |
353 |
收件人缺失或格式非法 |
504 |
缺少请求 token 参数(平台统一校验) |
505 |
请求 token 不存在 |
507 |
请求 token 额度不足 |
508 |
今日请求 token 已达上限 |
511 |
请求频率过高(QPS 超限) |
521 |
请求 token 余额不足 |
522 |
请求 token 额度和余额均不足 |
服务器状态码
| 状态码 | 说明 |
|---|---|
500 |
服务器错误 |
501 |
请求接口不存在 |
502 |
请求接口已下架 |
503 |
请求接口维护中 |
504 |
缺少请求token参数 |
505 |
请求token不存在 |
506 |
请求token已被封禁 |
507 |
请求token额度不足 |
508 |
今日请求token已达上限 |
509 |
请求ip不在token白名单内 |
510 |
请求token无权使用当前接口 |
511 |
接口请求频率过高,请稍后再试 |
512 |
该接口未开启在线测试功能 |
513 |
今日在线测试次数已达上限 |
514 |
今日该接口请求次数已达上限 |
515 |
该接口为会员专属接口,请携带会员token |
516 |
该接口为会员专属接口,请开通会员 |
517 |
接口请求过于频繁,已被临时限制 |
518 |
该接口需要实名认证,请先完成实名认证 |
519 |
当前Token今日请求次数已达上限 |
520 |
当前Token已被禁止使用 |
521 |
请求token余额不足 |
522 |
请求token额度和余额均不足 |
530 |
接口服务异常,请稍后再试 |
531 |
接口响应超时,请稍后再试 |
532 |
接口暂时不可用,请稍后再试 |
533 |
接口配置异常 |
534 |
请求参数错误,请检查后重试 |
535 |
接口返回数据异常 |
在线测试
在线调试接口,实时查看响应结果
返回结果
等待请求...
等待请求...
示例代码
查看多种编程语言的接口调用示例
/**
* API请求DEMO-PHP
*
* 本demo支持GET与POST请求。
*/
//你申请的token密钥
$API_TOKEN = 'YOUR_TOKEN';
//API接口地址
$API_URL = 'https://api.yunmge.com/api/mailsystem';
$get_post_data = array(
'token' => 'YOUR_TOKEN',
'username' => '无',
'userpass' => '无',
'mailusermail' => '无',
'mailtitle' => '无',
'mailcontent' => '无',
'host' => 'smtp.qq.com',
'port' => '465',
'mailishtml' => '1',
'fromname' => '云萌阁API邮局',
);
/*发起请求API接口:
第1个参数:API接口地址URL,跟上面的同名变量相对应,无需更改。
第2个参数:API接口参数数组,跟上面的同名变量相对应,无需更改。
第3个参数:请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
*/
$resdata = api::send($API_URL, $get_post_data, 'GET/POST'); //发起请求,注意这里要选择接口支持的协议,默认GET,可选POST
//打印请求结果
print($resdata);
///////////////你的业务代码可写在这里处理API返回的数据
/**
* API请求类
*/
class api
{
public static function send($API_URL, $get_post_data, $type)
{
$get_post_data = http_build_query($get_post_data);
$res = self::send_curl($API_URL, $type, $get_post_data, null);
return $res;
}
//封装好的CURL请求函数,支持POST|GET
public static function send_curl($API_URL, $type, $get_post_data)
{
$ch = curl_init();
if ($type == 'POST') {
curl_setopt($ch, CURLOPT_URL, $API_URL);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $get_post_data);
} elseif ($type == 'GET') {
curl_setopt($ch, CURLOPT_URL, $API_URL . '?' . $get_post_data);
}
curl_setopt($ch, CURLOPT_REFERER, $API_URL);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
$resdata = curl_exec($ch);
curl_close($ch);
return $resdata;
}
}
/**
* API请求DEMO-JavaScript
*
* 本demo支持GET与POST请求。
*/
//jQuery-Ajax
$.ajax({
url: 'https://api.yunmge.com/api/mailsystem',
data: {
token: 'YOUR_TOKEN',
username: '无',
userpass: '无',
mailusermail: '无',
mailtitle: '无',
mailcontent: '无',
host: 'smtp.qq.com',
port: '465',
mailishtml: '1',
fromname: '云萌阁API邮局',
},
type: 'GET/POST', //请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
dataType: 'json',
success: function(data) {
console.log(data); //请求成功,输出结果到控制台
},
timeout: 3000, //超时时间
error: function(data) {
console.log('请求失败'); //失败处理
}
});
/**
* API请求DEMO-NodeJs
*
* 本demo支持GET与POST请求。
*/
const https = require('https');
const querystring = require('querystring');
// 定义请求选项
const options = {
hostname: 'api.yunmge.com',
path: '/api/mailsystem',
method: 'GET/POST'
};
// 发送POST请求
const postData = querystring.stringify({
'token': 'YOUR_TOKEN',
'username': '无',
'userpass': '无',
'mailusermail': '无',
'mailtitle': '无',
'mailcontent': '无',
'host': 'smtp.qq.com',
'port': '465',
'mailishtml': '1',
'fromname': '云萌阁API邮局',
});
const postOptions = {
hostname: 'api.yunmge.com',
path: '/api/mailsystem',
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
'Content-Length': Buffer.byteLength(postData)
}
};
const postReq = https.request(postOptions, res => {
console.log(`statusCode: ${res.statusCode}`);
res.on('data', d => {
process.stdout.write(d);
});
});
postReq.on('error', error => {
console.error(error);
});
postReq.write(postData);
postReq.end();
import requests
url = "https://api.yunmge.com/api/mailsystem"
data = {
"token": "YOUR_TOKEN",
"username": "无",
"userpass": "无",
"mailusermail": "无",
"mailtitle": "无",
"mailcontent": "无",
"host": "smtp.qq.com",
"port": "465",
"mailishtml": "1",
"fromname": "云萌阁API邮局",
}
response = requests.post(url, data=data)
print(response.json())
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
"strings"
)
func main() {
apiURL := "https://api.yunmge.com/api/mailsystem"
// POST请求
data := url.Values{}
data.Set("token", "YOUR_TOKEN")
data.Set("username", "无")
data.Set("userpass", "无")
data.Set("mailusermail", "无")
data.Set("mailtitle", "无")
data.Set("mailcontent", "无")
data.Set("host", "smtp.qq.com")
data.Set("port", "465")
data.Set("mailishtml", "1")
data.Set("fromname", "云萌阁API邮局")
resp, err := http.Post(apiURL, "application/x-www-form-urlencoded", strings.NewReader(data.Encode()))
if err != nil {
fmt.Println("请求失败:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
public class ApiRequest {
public static void main(String[] args) {
try {
String apiUrl = "https://api.yunmge.com/api/mailsystem";
URL url = new URL(apiUrl);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setDoOutput(true);
// 构建POST参数
StringBuilder postData = new StringBuilder();
postData.append("token=").append(URLEncoder.encode("YOUR_TOKEN", "UTF-8"));
postData.append("&"); postData.append("username=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("userpass=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("mailusermail=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("mailtitle=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("mailcontent=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("host=").append(URLEncoder.encode("smtp.qq.com", "UTF-8"));
postData.append("&"); postData.append("port=").append(URLEncoder.encode("465", "UTF-8"));
postData.append("&"); postData.append("mailishtml=").append(URLEncoder.encode("1", "UTF-8"));
postData.append("&"); postData.append("fromname=").append(URLEncoder.encode("云萌阁API邮局", "UTF-8"));
byte[] postDataBytes = postData.toString().getBytes("UTF-8");
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
conn.setRequestProperty("Content-Length", String.valueOf(postDataBytes.length));
try (OutputStream os = conn.getOutputStream()) {
os.write(postDataBytes);
}
BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String line;
StringBuilder response = new StringBuilder();
while ((line = reader.readLine()) != null) {
response.append(line);
}
reader.close();
System.out.println(response.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading.Tasks;
class Program {
static async Task Main() {
string apiUrl = "https://api.yunmge.com/api/mailsystem";
using (HttpClient client = new HttpClient()) {
// POST请求
var formData = new Dictionary<string, string> {
{ "token", "YOUR_TOKEN" },
{ "username", "无" },
{ "userpass", "无" },
{ "mailusermail", "无" },
{ "mailtitle", "无" },
{ "mailcontent", "无" },
{ "host", "smtp.qq.com" },
{ "port", "465" },
{ "mailishtml", "1" },
{ "fromname", "云萌阁API邮局" },
};
var content = new FormUrlEncodedContent(formData);
HttpResponseMessage response = await client.PostAsync(apiUrl, content);
string result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
}
}
}
/**
* API请求DEMO-C
*
* 本demo支持GET与POST请求。
* 需要安装libcurl库
*/
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <curl/curl.h>
// API地址
const char* url = "https://api.yunmge.com/api/mailsystem";
// POST请求
void postRequest(CURL* curl) {
CURLcode res;
const char* postData = "token=YOUR_TOKEN&username=%E6%97%A0&userpass=%E6%97%A0&mailusermail=%E6%97%A0&mailtitle=%E6%97%A0&mailcontent=%E6%97%A0&host=smtp.qq.com&port=465&mailishtml=1&fromname=%E4%BA%91%E8%90%8C%E9%98%81API%E9%82%AE%E5%B1%80";
curl_easy_setopt(curl, CURLOPT_URL, url);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData);
res = curl_easy_perform(curl);
if(res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
}
int main() {
CURL* curl = curl_easy_init();
if(curl) {
postRequest(curl); curl_easy_cleanup(curl);
}
return 0;
}
/**
* API请求DEMO-C++
*
* 本demo支持GET与POST请求。
* 需要安装libcurl库
*/
#include <iostream>
#include <string>
#include <curl/curl.h>
int main() {
CURL* curl = curl_easy_init();
if(curl) {
std::string apiUrl = "https://api.yunmge.com/api/mailsystem";
// POST请求
std::string postData = "token=YOUR_TOKEN&username=%E6%97%A0&userpass=%E6%97%A0&mailusermail=%E6%97%A0&mailtitle=%E6%97%A0&mailcontent=%E6%97%A0&host=smtp.qq.com&port=465&mailishtml=1&fromname=%E4%BA%91%E8%90%8C%E9%98%81API%E9%82%AE%E5%B1%80";
curl_easy_setopt(curl, CURLOPT_URL, apiUrl.c_str());
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData.c_str());
CURLcode res = curl_easy_perform(curl);
if(res != CURLE_OK) {
std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;
}
curl_easy_cleanup(curl);
}
return 0;
}
.版本 2
.支持库 spec
.子程序 _启动子程序
.局部变量 url, 文本型
.局部变量 data, 文本型
.局部变量 result, 文本型
url = "https://api.yunmge.com/api/mailsystem"
data = "token=YOUR_TOKEN&username=%E6%97%A0&userpass=%E6%97%A0&mailusermail=%E6%97%A0&mailtitle=%E6%97%A0&mailcontent=%E6%97%A0&host=smtp.qq.com&port=465&mailishtml=1&fromname=%E4%BA%91%E8%90%8C%E9%98%81API%E9%82%AE%E5%B1%80"
result = 网页_访问 (url, 1, data, , , , , , , , , )
调试输出 (result)
常见问题
查找常见问题的解决方案
一、这个接口是做什么的?
用你自己的 SMTP 邮箱账号代发邮件,适合验证码、订单通知、告警等事务性邮件。发件地址就是你传入的 username,收件人看到的是你的邮箱。
二、userpass 该填什么?
填 SMTP 授权码,不是网页登录密码:
- QQ 邮箱:设置 → 账户 → 开启「POP3/SMTP 服务」→ 生成授权码(16 位字母)
- 163 邮箱:设置 → POP3/SMTP/IMAP → 开启服务 → 设置客户端授权密码
- 腾讯企业邮:设置 → 收发信设置 → 开启 SMTP → 生成客户端专用密码
填登录密码会返回 350,debug 提示 Could not authenticate。
三、host 和 port 怎么配?
- QQ / Foxmail:
smtp.qq.com,端口465(SSL)或587(STARTTLS) - 163:
smtp.163.com,端口465 - 腾讯企业邮:
smtp.exmail.qq.com,端口465
不传时默认 smtp.qq.com:465。端口会决定加密方式:465 用 SSL,587/25 用 STARTTLS。
四、mailcontent 为什么要 base64?
GET 请求中中文与 + / = & 等字符容易被 URL 转义破坏。base64 后传输最稳。直接传纯文本也能识别:服务端先尝试 base64 解码,结果不是合法 UTF-8 时按原文发送。
HTML 邮件请设 mailishtml=1(默认),并把完整 HTML 片段 base64 后传入。
五、可以发给多个收件人吗?
可以,mailusermail 用英文逗号分隔。本接口是事务性通知用途,请勿用于营销群发。
六、返回 350 怎么排查?
看 debug 字段:
Could not authenticate:授权码错误、SMTP 服务未开启、或账号异常Could not connect to SMTP host:host/port 填错,或该端口被服务商限制SMTP Error: Data not accepted:收件地址被拒或内容命中反垃圾规则
七、这个接口收费吗?
v1 免费。若不想自备邮箱,可改用 v2 版本(/api/v2/mailsystem):使用平台内置发件邮箱,按次计费 1 额度或 0.001 元,会员免费。