发送普通邮件

POST

https://qyapi.weixin.qq.com/cgi-bin/exmail/app/compose_send

应用可以通过该接口发送普通邮件，支持附件能力。

权限说明

自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）

第三方应用需具有“邮件”权限

代开发自建应用需具有“邮件”权限

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/exmail/app/compose_send' \
--header 'Content-Type: application/json' \
--data-raw '{
    "to": {
        "emails": [
            "string"
        ],
        "userids": [
            "string"
        ]
    },
    "cc": {
        "emails": [
            "string"
        ],
        "userids": [
            "string"
        ]
    },
    "bcc": {
        "emails": [
            "string"
        ],
        "userids": [
            "string"
        ]
    },
    "subject": "string",
    "content": "string",
    "attachment_list": [
        {
            "file_name": "string",
            "content": "string"
        }
    ],
    "content_type\t": "string"
}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok"
}

请求参数

Query 参数

access_token

string

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

object

必需

收件人，to.emails 和 to.userids 至少传一个

emails

array[string]

收件人，邮箱地址

可选

userids

array[string]

可选

收件人，企业内成员的userid

object

抄送

可选

emails

array[string]

抄送人，邮箱地址

可选

userids

array[string]

可选

抄送人，企业内成员的userid

bcc

object

密送

可选

emails

array[string]

密送人，邮箱地址

可选

userids

array[string]

可选

密送人，企业内成员的userid

subject

string

标题

必需

content

string

内容

必需

attachment_list

array [object {2}]

附件相关

必需

file_name

string

文件名

可选

content

string

可选

文件内容（base64编码），所有附件加正文的大小不允许超过50M, 且附件个数不能超过200个

content_type

string

可选

内容类型 html，text（默认是html）

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

修改于 2022-12-07 03:40:59

回调通知

发送日程邮件