Определение заголовка X-SMTPAPI

Question

Вопрос 1: Нужно ли строго следовать порядку при определении заголовка X-SMTPAPI , упомянутого в документе?

Док (http://sendgrid.com/docs/API_Reference/SMTP_API/) упоминает о нем, как это:

{ 
    "to": [ 
    "ben@sendgrid.com", 
    "joe@sendgrid.com" 
    ], 
    "sub": { 
    "%name%": [ 
     "Ben", 
     "Joe" 
    ], 
    "%role%": [ 
     "%sellerSection%", 
     "%buyerSection%" 
    ] 
    }, 
    "section": { 
    "%sellerSection%": "Seller information for: %name%", 
    "%buyerSection%": "Buyer information for: %name%" 
    }, 
    "category": "Orders", 
    "unique_args": { 
    "orderNumber": "12345", 
    "eventID": "6789" 
    }, 
    "filters": { 
    "footer": { 
     "settings": { 
     "enable": 1, 
     "text/plain": "Thank you for your business" 
     } 
    } 
    } 
} 


So, my email header in this case would look like the following in coldfusion: 



<cfset myheaderdefinition = XMLFormat('X-SMTPAPI|{ 
     "to": [ 
     "ben@sendgrid.com", 
     "joe@sendgrid.com" 
     ], 
     "sub": { 
     "%name%": [ 
      "Ben", 
      "Joe" 
     ], 
     "%role%": [ 
      "%sellerSection%", 
      "%buyerSection%" 
     ] 
     }, 
     "section": { 
     "%sellerSection%": "Seller information for: %name%", 
     "%buyerSection%": "Buyer information for: %name%" 
     }, 
     "category": "Orders", 
     "unique_args": { 
     "orderNumber": "12345", 
     "eventID": "6789" 
     }, 
     "filters": { 
     "footer": { 
      "settings": { 
      "enable": 1, 
      "text/plain": "Thank you for your business" 
      } 
     } 
     } 
    } 
    ') > 

Вопрос № 2: Есть ли способ, я определил мой заголовок выглядит хорошо?

Больше уточнений на вопрос № 1:

1.1 Нужно ли мне использовать, чтобы, подразделам, роли, раздела и т.д. в том же порядке, как указано? Или я могу пропустить одну из них, если я их не использую?

1.2 Как определить, что ожидает sendgrid для unique_args и других полей?

Answer 1

1 - 1.1 Вы можете использовать любое количество параметров SMTPAPI в любом порядке, в объекте JSON, который вы предоставляете SendGrid. Вы можете опустить те, которые вы не используете. Образец, предоставленный в документах SendGrid, является только этим, а не требованием.

1.2 unique_args и остальные параметры являются полями, предназначенными только для вас. SendGrid ничего не ждет. По мере предоставления параметров SendGrid будет выполняться на них, как описано в SMTPAPI Documentation.

2 Ваши настройки выглядят не так, хотя я не знаком с ColdFusion, это не выглядит так, как будто вы правильно определяете заголовок электронной почты. Я бы указал на my previous answer to your previous question относительно того, как это установить.

---

Однако, основываясь на этом и предыдущих вопросов, я должен спросить, вы уверены, что вы хотите использовать SMTPAPI SendGrid или просто использовать SMTP для отправки электронной почты в SendGrid?

SMTPAPI предоставляет гораздо больше функциональных возможностей для электронной почты на основе параметров, предоставляемых ему через объект JSON. Однако отправка через SMTP просто переносит ваше сообщение в SendGrid с использованием протокола SMTP.

---

EDIT: Для того, чтобы дополнительно проверить SMTPAPI заголовок, вы можете использовать SMTPAPI Header Validator