Headers 字段对应的是用户希望在邮件头添加自己的多个字段的 JSON 表示,比如说传入自己的 Message-ID。
邮件头目前可以添加的标准字段是 Message-ID,标准字段会覆盖掉邮件头中原有的值,非标准字段需要以 X-User- 开头,会被追加到邮件头中,例如
{
"Message-ID": "<msg0001@example.com>",
"X-User-UID1": "UID-1-000001",
"X-User-UID2": "UID-2-000001"
}
以上 JSON 表示在邮件头中加入 3 个字段,分别是 Message-ID,X-User-UID1 和 X-User-UID2。最后邮件 eml 效果如下
目前支持 JSON 传入的邮件头最多 10 个,标准字段和非标准字段都需要符合标准中对头的语法要求。
下面对可能传出的错误消息作出解释:
user header num exceeds the limit,表示 JSON 传入的头数量过多。
some user header has invalid name,表示传入的头中,部分头的名字不对,传入了不允许的标准标头名字(From、To 等等)或者自定义标头没有以 X-User- 开头。
some user header length exceeds the limit,表示传入的头中,部分头的长度(名字加上值)超出限制。
some user header has invalid grammar,表示传入的头中,部分头的名字或者值不符合RFC语法要求。
the format of the message-id is incorrect. please refer to RFC 5322 section 3.6.4,特定于 Message-ID 头字段,表示 Message-ID 不符合语法要求。
若有收获,就点个赞吧
文档内容是否对您有帮助?