云信邮箱分发服务文档

邮箱ID	类型	发件人邮箱
1	136	lsphp6@163.com

1. 接口基础信息

接口功能：通过后台配置的邮箱账号发送邮件，支持单邮箱/多邮箱批量接收

请求地址：

https://yx.xn--ekvru.cc/api.php

支持请求方式：GET / POST

返回格式：JSON（包含状态码、提示信息及核心数据）

2. 请求参数说明

参数名	是否必传	类型	说明
id	是	数字	后台配置的邮箱ID（从弹窗公告或【邮箱管理】列表中获取，确保状态为“启用”）
mail	是	字符串	接收邮箱，多个邮箱用英文逗号分隔（示例：a@126.com,b@qq.com）
nr	是	字符串	邮件内容（含中文或特殊字符时，建议做URL编码，避免请求失败）
title	否	字符串	邮件标题（未传时默认：“来自云信邮箱分发的通知邮件”）

3. 请求示例

3.1 GET请求示例（浏览器/Postman直接测试）

请求地址（自动填充当前域名）：

https://yx.xn--ekvru.cc/api.php?id=1&mail=test2@qq.com&nr=这是测试内容&title=测试邮件

使用场景：快速测试接口可用性，直接在浏览器地址栏输入即可发起请求

3.2 POST请求示例（推荐：代码调用/表单提交）

请求地址：https://yx.xn--ekvru.cc/api.php

请求参数（x-www-form-urlencoded 格式）：

id=1&mail=test@126.com&nr=这是POST方式测试内容&title=POST测试邮件

使用场景：项目中代码调用（如PHP/Java/Python），参数放在请求体中，更安全

4. 返回结果说明

4.1 发送成功返回（code=200）

{
    "code": 200,
    "msg": "邮件发送成功",
    "data": {
        "config_id": 1,
        "target_mail": "test@126.com",
        "send_time": "2025-10-31 16:45:30",
        "log_id": 1001,
        "sender_email": "service@tedev.cn"
    }
}

4.2 发送失败返回（code=400/500）

// 示例1：参数缺失
{
    "code": 400,
    "msg": "请求失败：必传参数id或mail不能为空",
    "data": []
}

// 示例2：邮箱ID无效
{
    "code": 400,
    "msg": "请求失败：邮箱ID=5不存在或已禁用",
    "data": []
}

// 示例3：SMTP连接失败
{
    "code": 500,
    "msg": "发送失败：SMTP服务器连接超时",
    "data": []
}

5. 最近API请求日志（仅显示最新10条）