API支持自定义头部说明

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 效果如下

image

目前支持 JSON 传入的邮件头最多 10 个,标准字段和非标准字段都需要符合标准中对头的语法要求。

下面对可能传出的错误消息作出解释:

  1. user header num exceeds the limit,表示 JSON 传入的头数量过多。

  2. some user header has invalid name,表示传入的头中,部分头的名字不对,传入了不允许的标准标头名字(From、To 等等)或者自定义标头没有以 X-User- 开头。

  3. some user header length exceeds the limit,表示传入的头中,部分头的长度(名字加上值)超出限制。

  4. some user header has invalid grammar,表示传入的头中,部分头的名字或者值不符合RFC语法要求。

  5. the format of the message-id is incorrect. please refer to RFC 5322 section 3.6.4,特定于 Message-ID 头字段,表示 Message-ID 不符合语法要求。

若有收获,就点个赞吧