Sendgrid-nodejs: उदाहरण को समझना आसान है

नमस्कार @julesbou ,

नाराज रेंट मेरे साथ ठीक हैं, खासकर अगर उनके पास समाधान संलग्न हैं :)

हमें बताने के लिए समय निकालने के लिए धन्यवाद।

वर्तमान में हम अगले पुनरावृत्ति के लिए सुधार की योजना बना रहे हैं, इसलिए आपके पास अच्छा समय था!

यदि आपके पास कोई अन्य विशेष अनुरोध है, तो कृपया इस धागे में या तो हमें बताएं या अतिरिक्त मुद्दे खोलें।

धन्यवाद!

हम सहायक वर्ग का उपयोग कैसे करते हैं? सब मैं करना चाहता हूँ नाम से सेट है ??

@jsgandalf ,

सबसे आसान तरीका है: https://github.com/sendgrid/sendgrid-nodejs#hello -email, विशेष रूप से: https://github.com/sendgrid/sendgrid-nodejs/blob-master/examples/helpers/mail/example। js # L4

आप केवल अपने स्वयं के json का निर्माण इस प्रकार कर सकते हैं: https://github.com/sendgrid/sendgrid-nodejs/blob/master/examples/mail/mail.js#L31 (यहाँ json का अवलोकन है: https: / /sendgrid.com/docs/API_Reference/Web_API_v3/Mail/index.html]

धन्यवाद!

बहुत मददगार! यह रीडमी पर होना चाहिए !!

@jsgandalf @thinkingsouble मैं भी पुस्तकालय का उपयोग करने के लिए काफी निराशाजनक लगता हूं। मैं एक टेम्पलेट ईमेल भेजने की कोशिश कर रहा हूं। मुझे यहाँ उदाहरण बहुत उपयोगी नहीं लगे। मैं ईमेल पते से "टू" और "सेट" करने के बारे में उलझन में हूं, और यह कोड मेरा ईमेल भी नहीं भेजता है। मैं पिछले तीन दिनों से अपना सिर खुजला रहा हूं। कोई मदद?

प्रतिक्रिया @bcootner के लिए धन्यवाद। आपका अनुरोध इस कतार को ठीक करने में मदद करता है। यह एक मुद्दा है जिसे मैं करने के लिए खुजली कर रहा हूं।

इस समय में, उम्मीद है कि इस उदाहरण से मदद मिलेगी:

var sg = require('sendgrid').SendGrid(process.env.SENDGRID_API_KEY)

function helloTemplate(){
  var helper = require('sendgrid').mail

  from_email = new helper.Email("[email protected]")
  to_email = new helper.Email("[email protected]")
  subject = "Hello World from the SendGrid Node.js Library"
  content = new helper.Content("text/plain", "some text here")
  mail = new helper.Mail(from_email, subject, to_email, content)
  // The constructor above already creates our personalization object
  // -name- and -card- are substitutions in my template
  substitution = new helper.Substitution("-name-", "Example User")
  mail.personalizations[0].addSubstitution(substitution)
  substitution = new helper.Substitution("-card-", "Denver")
  mail.personalizations[0].addSubstitution(substitution)
  mail.setTemplateId("YOUR_TEMPLATE_ID")
  return mail.toJSON()
}

function send(toSend){
  //console.log(JSON.stringify(toSend, null, 2))
  //console.log(JSON.stringify(toSend))

  var sg = require('sendgrid').SendGrid(process.env.SENDGRID_API_KEY)

  var requestBody = toSend
  var emptyRequest = require('sendgrid-rest').request
  var requestPost = JSON.parse(JSON.stringify(emptyRequest))
  requestPost.method = 'POST'
  requestPost.path = '/v3/mail/send'
  requestPost.body = requestBody
  sg.API(requestPost, function (response) {
    console.log(response.statusCode)
    console.log(response.body)
    console.log(response.headers)
  })
}

send(helloTemplate())

यदि आपको अतिरिक्त सहायता की आवश्यकता है, तो कृपया पहुंचें।

@ समय और विचारशील प्रतिक्रिया के लिए धन्यवाद। मेरे पास निम्नलिखित कोड हैं:

    var  sg = require('sendgrid').SendGrid("SG.**** .. ***6o");

    function welcomeTemplate() {
         console.log("template")
         var helper = require('sendgrid').mail
         from_email = new helper.Email("[email protected]")
         to_email = new helper.Email("[email protected]")
         subject = "Hello World from the SendGrid Node.js Library"
         content = new helper.Content("text/plain", "some text here")
         mail = new helper.Mail(from_email, subject, to_email, content)
         substitution = new helper.Substitution("-Name-", "bcootner")
         mail.personalizations[0].addSubstitution(substitution)
         mail.setTemplateId("5a****-*******-******-9")    //The ID of my Transactional Template
         return mail.toJSON()
}

function sendMail(toSend) {
     console.log("Send")
     var sg = require('sendgrid').SendGrid("SG.***....****o")
     var requestBody = toSend
     var emptyRequest = require('sendgrid-rest').request
     var requestPost = JSON.parse(JSON.stringify(emptyRequest))
     requestPost.method = 'POST'
     requestPost.path = '/v3/mail/send'
     requestPost.body = requestBody
     sg.API(requestPost, function (response) {
            console.log(response.statusCode)
            console.log(response.body)
            console.log(response.headers)
       })
}

और फिर मैं sendMail(welcomeTemplate()) के साथ इस कोड को कॉल करता हूं लेकिन यह काम नहीं करता है। "टेम्प्लेट" और "सेंड" लॉग में दिखाई देते हैं लेकिन स्टेटसकोड, बॉडी या हेडर दिखाई नहीं देते हैं, कोई ईमेल प्राप्त नहीं हो रहा है और मेरे डैशबोर्ड पर कुछ भी नहीं दिखता है।

बाद requestPost.body = requestBody आप कृपया सकता है console.log(JSON.stringify(requestBody)) और मुझे पता है तुम क्या मिलता है।

@thinkingsनुमा कुछ डिबगिंग के बाद ऐसा लगता है कि लाइन var emptyRequest = require('sendgrid-rest').request बाद लॉग में कुछ भी प्रिंट नहीं होता है। पहले "टेम्प्लेट" लॉग हो जाता है, फिर लगभग 5 मिनट बाद "सेंड" प्रिंट हो जाता है (और अगर मैं आपके द्वारा भेजे गए फंक्शन को लाइक करता हूं तो वे काम ठीक होते हैं)। क्या ऐसा कुछ है जो मुझे इस आवश्यकता के बयान के लिए याद आ रहा है, मैंने सिर्फ npm install sendgrid

कृपया इसे आज़माएँ:

A. निम्न पेलोड के साथ post.json नामक फाइल बनाएं:

{"content":[{"type":"text","value":"Hello, World!"}],"from":{"email":"[email protected]"},"personalizations":[{"subject":"Hello, World!","to":[{"email":"[email protected]"}]}]}

B. उदाहरण ईमेल बदलें

C. निम्नलिखित कमांड चलाएँ:

curl -X "POST" "https://api.sendgrid.com/v3/mail/send" \
        -H "Authorization: Bearer $SENDGRID_API_KEY"  \
        -H "Content-Type: application/json" \
        -d @post.json

D. या तो $ SENDGRID_API_KEY को अपने API कुंजी से बदलें, या अपनी API कुंजी को SENDGRID_API_KEY नामक एक पर्यावरण चर में जोड़ें।

@thinkingsouble मुझे वह टेस्ट ईमेल प्राप्त हुआ, मैं हैलो टेस्ट को ठीक करने में भी सक्षम था, यह सिर्फ इन टेम्प्लेट को काम नहीं करना है।

संपादित करें: इसलिए मैंने var emptyRequest = require('sendgrid-rest').request को var emptyRequest = sg.emptyRequest() var emptyRequest = require('sendgrid-rest').request साथ बदल दिया और वह ईमेल भेजता है, टेम्पलेट डिज़ाइन या किसी भी छवियों से कोई स्वरूपण नहीं है।

@bcootner ,

दुर्भाग्य से, मैं आपकी त्रुटि को पुन: उत्पन्न नहीं कर सकता, इसलिए मैं उस चरण की मदद करने की कोशिश कर रहा हूं जहां कोई समस्या हो सकती है। चूंकि आप कर्ल के माध्यम से एक ईमेल भेज सकते हैं, इसका मतलब है कि आपकी एपीआई कुंजी अच्छी है। शायद टेम्पलेट आईडी में कोई समस्या है?

यदि आप mail.setTemplateId("5a****-*******-******-9") निकालते हैं तो क्या ईमेल भेजता है?

@thinkingserious तो अगर मैं setTemplateID को दूर यह परीक्षण "SendGrid Node.js लाइब्रेरी से नमस्ते विश्व" भेजता है।

मुझे यकीन नहीं है कि आपने मेरा संपादन देखा है, लेकिन var emptyRequest = require('sendgrid-rest').request को var emptyRequest = sg.emptyRequest() के साथ बदलकर मेरे टेम्पलेट का पाठ भेजता है, लेकिन कोई स्वरूपण नहीं है (कोई फ़ॉन्ट नहीं, कोई चित्र नहीं)। मुझे कंसोल से अब निम्नलिखित प्रिंट आउट मिलता है।

2016-07-13T00:01:07.514157+00:00 app[web.1]:   date: 'Wed, 13 Jul 2016 00:01:07 GMT',
2016-07-13T00:01:07.514159+00:00 app[web.1]:   connection: 'close',
2016-07-13T00:01:07.514157+00:00 app[web.1]:   date: 'Wed, 13 Jul 2016 00:01:07 GMT',
2016-07-13T00:01:07.514158+00:00 app[web.1]:   'content-type': 'text/plain; charset=utf-8',
2016-07-13T00:01:07.502390+00:00 app[web.1]: 202
2016-07-13T00:01:07.502454+00:00 app[web.1]: 
2016-07-13T00:01:07.514155+00:00 app[web.1]: { server: 'nginx',
2016-07-13T00:01:07.514159+00:00 app[web.1]:   connection: 'close',
2016-07-13T00:01:07.514161+00:00 app[web.1]:   'x-frame-options': 'DENY' }

कुछ मुझे लगता है कि यह 'पाठ / सादे' के साथ एक समस्या है, लेकिन मुझे यकीन नहीं है। एक बार फिर धन्यवाद!

हे @bcootner , मैंने अभी भी एक ही मुद्दे का अनुभव किया है और कुछ घंटों के लिए मेरे सिर को खरोंच रहा है, लेकिन इसे हल करने में कामयाब रहा। यह महसूस करता है कि वास्तव में ईमेल भेजने से पहले बहुत अधिक अनावश्यक सामान की आवश्यकता है, लेकिन ऐसा करने के लिए मेरा सहायक कार्य है:

_परम_

• से (जैसे '[email protected]')
• , (उदाहरण के लिए '[email protected]')
• विषय (जैसे 'परीक्षण विषय')
• संदेश (उदाहरण के लिए 'परीक्षण संदेश')
• टेम्पलेट (टेम्पलेट आईडी जो आप उपयोग करना चाहते हैं)
• templateVariables (ऑब्जेक्ट, जहां कुंजी - ईमेल में चर, मान - मान को इसके साथ बदलने के लिए) { ":name": "someName", ":email": "someEmail" } । ध्यान दें कि :email और :name यह है कि मैंने ईमेल टेम्प्लेट में अपने चर कैसे सेट किए हैं, यह -email- या आपके पास जो कुछ भी हो सकता है
• सफलता कॉलबैक
• त्रुटि कॉलबैक

    let sendTemplateMail =  (from, to, subject, message, template, templateVariables, successCallback, errorCallback) => {
        var sg = require('sendgrid').SendGrid(process.env.SENDGRID_API_KEY),
            helper = require('sendgrid').mail,
            content_text = new helper.Content("text/plain", message),
            content_html = new helper.Content("text/html", message),
            request = sg.emptyRequest(),
            email_to = new helper.Email(to),
            email_from = new helper.Email(from),
            mail = new helper.Mail(email_from, subject, email_to, content_text),
            personalization = new helper.Personalization();

        personalization.addTo(email_to);
        personalization.setSubject(subject);

        mail.setTemplateId(template);
        mail.addContent(content_html);

        for(var key in templateVariables) {
            if(templateVariables.hasOwnProperty(key)) {
                var substitution = new helper.Substitution(key, templateVariables[key]);
                personalization.addSubstitution(substitution);
            }
        }

        mail.addPersonalization(personalization);

        request.method = 'POST';
        request.path = '/v3/mail/send';
        request.body = mail.toJSON();

        sg.API(request, (json) => {
            if(json.statusCode >= 300) {
                errorCallback(json);
            } else {
                successCallback(json);
            }
        });
    }

दस्तावेज को बुनियादी, सरल उदाहरणों के साथ वास्तव में कुछ रिफैक्टिंग की आवश्यकता होती है। आशा है कि मेरा कार्य आपकी सहायता करेगा :)

@ByEmke आपके समर्थन के लिए धन्यवाद! क्या आप कृपया हमें [email protected] पर ईमेल कर सकते हैं आपके साथ टी-शर्ट का आकार और मेलिंग पता?

प्रलेखन के संबंध में, एक रिफ्लेक्टर इस रास्ते पर है और साथ ही मेल सहायक के लिए भी है। हम आपकी सभी प्रतिक्रिया एकत्र कर रहे हैं और अगले पुनरावृत्ति के बारे में उत्साहित हैं।

इसके अलावा, एक बड़ा भ्रम यह है कि आपको अभी भी टेम्पलेट का उपयोग करते समय सामग्री सेट करने की आवश्यकता है। सौभाग्य से, यह बहुत जल्द (दिन) बदल जाएगा।

@bcootner मुझे लगता है कि आपने इसे content_html = new helper.Content("text/html", message) । सौभाग्य से, यह आवश्यकता कुछ दिनों में दूर हो रही है, हमारी टीम वर्तमान में इस व्यवहार को बदल रही है ताकि जब आप एक टेम्पलेट निर्दिष्ट करते हैं, तो आपको सामग्री सेट करने की आवश्यकता नहीं होगी।

इस मुद्दे पर आपकी मदद के लिए @ByEmke @thinkingsouble धन्यवाद, मैं इसे पिछले कोड के साथ काम करने में कामयाब रहा:

 var sg = require('sendgrid').SendGrid("SendGrid API Key" or <environment variable>)

function sendEmail(tempID){
    var helper = require('sendgrid').mail;
    from_email = new helper.Email("[email protected]")
    to_email = new helper.Email("[email protected]")
    subject = "Dummy Subject"
    content = new helper.Content("text/html", "dummy content")
    mail = new helper.Mail(from_email, subject, to_email, content)

    substitution = new helper.Substitution("-name-", "User's Name")
    mail.personalizations[0].addSubstitution(substitution)
    mail.setTemplateId(tempID)
    var requestBody = mail.toJSON()
    var requestPost = JSON.parse(JSON.stringify(sg.emptyRequest()))
    requestPost.method = 'POST'
    requestPost.path = '/v3/mail/send'
    requestPost.body = requestBody
    sg.API(requestPost, function (response) {
       console.log(response.statusCode)
       console.log(response.body)
       console.log(response.headers)
  })
}

एक बार फिर धन्यवाद!

मुझे यह भी लगता है कि डॉक्स का पालन करना काफी कठिन है, खासकर जब टेम्प्लेट और कुछ अन्य सुविधाओं का उपयोग करते हुए।

मैं अनुरोध को पसंद करता हूं। कोई व्यक्ति {}} सिंटैक्स पर सहायक () सिंटैक्स पर काम करता है क्योंकि यह चीजों को अधिक क्रियाशील बनाता है और पढ़ने में आसान होता है (मेरे लिए कम से कम)।

मैंने डॉक्स के माध्यम से जाने, परिवर्तनों को परखने, आपके उदाहरणों को देखने और फिर से यहां आने के लिए फिर से प्रयास करने और यह पता लगाने के लिए काफी समय बिताया कि आपको _do_ को टेम्पलेट का उपयोग करते समय सामग्री सेट करने की आवश्यकता है, हालांकि डॉक्स राज्य अन्यथा। अर्घ। इस तरह से सामान आपको पागल कर सकता है। वैसे भी @ByEmke को काम करने का उदाहरण देने के लिए

@peterkuiper (या मुझे एडम :) कहना चाहिए)

प्रतिक्रिया के लिए धन्यवाद, हम बहुत रुचि रखते हैं कि कैसे हम लाइब्रेरी डॉक्स को बेहतर बना सकते हैं।

स्पष्ट होने के लिए, क्या आप इनका उल्लेख कर रहे हैं? https://github.com/sendgrid/sendgrid-nodejs/blob/master/USAGE.m

सामग्री के मुद्दे के संबंध में (हमने आप सभी को सुना :)), यह सिर्फ तय के बारे में है। हम एपीआई के लिए एक रिलीज को तैनात करेंगे जिसमें टेम्पलेट का उपयोग करते समय सामग्री को सेट करने की आवश्यकता नहीं होगी। हम आशा करते हैं कि परिवर्तन से टेम्प्लेट का अनुभव बेहतर होगा।

@thinkingsouble मैं sendgrid.com (यानी https://sendgrid.com/docs/API_Reference/Web_API_v3/Mail/index.html) पर डॉक्स

मैं उस फ़ाइल को ब्राउज़ कर रहा था और मुझे उस चीज़ का एक यादृच्छिक उदाहरण मिला, जो मुझे भ्रामक लगता है:

var request = sg.emptyRequest()
request.queryParams["start_time"] = '1'
request.queryParams["limit"] = '1'
request.queryParams["end_time"] = '1'
request.queryParams["offset"] = '1'
request.method = 'GET'
request.path = '/v3/suppression/blocks'
sg.API(request, function (response) {
    console.log(response.statusCode)
    console.log(response.body)
    console.log(response.headers)
  })

किस प्रकार के start_time, limit, end_time और ऑफसेट हैं और इनका क्या अर्थ है? क्या अधिक क्वेरीपराम हैं? और यह अनुरोध क्यों नहीं है।

उपयोगकर्ता गाइड का लिंक है (जो बिल्कुल भी मदद नहीं करता है) जबकि एपीआई डॉक्स के लिए एक लिंक होना चाहिए था जो https://sendgrid.com/docs/API_Reference/Web_API_v3.blocks.html तक चीजों को साफ करता है

इसलिए आपको यह पता लगाने की कोशिश करनी होगी कि आपको कौन सी जानकारी मिलनी चाहिए।

बहुत बढ़िया प्रतिक्रिया @peterkuiper!

मैं आपको बाहर भी स्वाहा करना चाहूंगा। कृपया हमें अपना टी-शर्ट आकार और मेलिंग पता [email protected] पर

हम क्वेरी और प्रतिक्रिया निकायों के विवरणों को शामिल करने के लिए USAGE.md डॉक्स को अपडेट करेंगे।

टेम्प्लेट के बारे में, वहां की योजना एक सहायक बनाने की है, जैसे हमने मेल एंडपॉइंट के लिए किया था, सामान्य उपयोग के मामलों के उदाहरणों के साथ। इसके अलावा, एक फिक्स आ रहा है जहां आपको टेम्प्लेट का उपयोग करते समय सामग्री को निर्दिष्ट नहीं करना होगा। वह भ्रम का एक बड़ा स्रोत है।

@ सोच-समझकर शांत, धन्यवाद :) ईमेल भेजा गया!

जब मैं उस पर था, मैंने कुछ और देखा जो सर्वोत्तम प्रथाओं को संदर्भित करता है (और मेरी टीम के लिए कुछ भ्रम पैदा कर रहा है)। मेरे एक साथी ने कुछ सुविधाओं के लिए टेम्पलेट बनाए (यानी ईमेल सत्यापित करें) और सत्यापित-एलएमबी, सत्यापन-एन आदि को जोड़ा। इसलिए प्रत्येक टेम्पलेट मूल रूप से केवल पाठ (भिन्न भाषा) के अंतर के साथ समान था। मैंने <% विषय%> en <% body%> देखा है और इसका कोई संदर्भ नहीं मिल सका है (TL, DR मेरी ओर से शायद) इसलिए मुझे लगता है कि यह आपके अंत में एक आंतरिक प्रतिस्थापन है जो API का उपयोग करते समय होता है।

मैं उत्सुक हूँ कि एक "सामान्य" अभ्यास क्या हो सकता है:

• एक अलग भाषा में प्रत्येक सुविधा के लिए एक टेम्पलेट बनाएं और केवल कुछ मामूली प्रतिस्थापन (यानी नाम) करें

ऐसा लगता है कि जब आप अपने टेम्पलेट के कुछ हिस्सों को बदलते हैं तो इस दृष्टिकोण का उपयोग करने से बहुत काम हो सकता है। निश्चित नहीं है कि आप "टेम्प्लेट टेम्प्लेट" (अर्थात हेडर / फ़ूटर / जो भी भाग) बना पाएंगे। साथ ही, 300 टेम्प्लेट की सीमा आसानी से पूरी हो सकती है, जब आपके पास बहुत सी अलग-अलग भाषाएं हों (यह हमारे मामले में समस्या नहीं है)।

• प्रत्येक सुविधा के लिए एक टेम्पलेट बनाएं और अपने एप्लिकेशन से शरीर सेट करने के लिए <% body%> का उपयोग करें और बस एक "मास्टर" टेम्पलेट (या उप टैग पर अपने उपयोग करें)

आशा है कि सवाल समझ में आता है :)

@peterkuiper ,

मुझे नहीं पता, लेकिन मैंने कुछ महसूस किया है। मैं जो कुछ भी खोजता हूं उसका जवाब दूंगा। धन्यवाद!

@thinkings रहस्यमय मैंने संस्करण 2.0.0 का उपयोग करके समाप्त किया, जो मुझे वास्तव में पसंद है कि यह कैसे काम कर रहा है:

var client = require("sendgrid")("key");

client.send({
  to: "[email protected]",
  from: "[email protected]",
  subject: "subject",
  text:  "hello"
  // Or using the html property:
  // html: "Hello <strong>World!</strong>!"
}, fn);

मैं यह देखना चाह रहा हूं कि यह संस्करण 3.x.x में कैसा लगेगा। मुझे लगता है कि वर्तमान उदाहरण वास्तव में भ्रामक हैं।

शानदार प्रतिक्रिया @IonicaBizau!

हम निश्चित रूप से अगले पुनरावृत्ति के लिए आपके विचारों पर विचार करेंगे।

@thinkings रहस्यमय महान! फिर भी, मैं जानना चाहूंगा कि यह 3.x.x में कैसा लगेगा।

https://github.com/sendgrid/sendgrid-nodejs#quick -start

कोई भी एक-से-एक मैपिंग नहीं है क्योंकि यह क्लाइंट खरोंच से वी 2 मेल एंडपॉइंट से डिकॉय करने और वी 3 एंडपॉइंट तक पहुंचने की अनुमति देता है।

उस ने कहा, मेल हेल्पर का उद्देश्य उस बिंदु पर पहुंचना है जहां कॉल उतना आसान हो सकता है जितना कि v2 के साथ था। हम अभी वहाँ नहीं हैं, हम शुरुआत में वापस आ रहे हैं और कई और पुनरावृत्तियों की प्रतीक्षा कर रहे हैं।

@thinkingsouble मैंने वह देखा, लेकिन मुझे निम्नलिखित बिंदु पसंद नहीं हैं:

1. यह भ्रमित करने वाला है क्योंकि वैश्विक चर ( var या let या समान कीवर्ड के बिना घोषित किए गए) हैं। उदा: from_email = new helper.Email("[email protected]") बजाय var from_email = ...
2. एक ईमेल संसाधन के लिए new helper.Email का उपयोग करना बहुत ही अमित्र है। यह संभवतः मॉड्यूल के अंदर निचले स्तर की कार्यक्षमता में लपेटा जा सकता है। Content , Mail आदि के लिए समान चीज़
3. मैन्युअल रूप से method , path और body फिर से सेट करना काफी अशुभ है।
4. कॉलबैक फ़ंक्शन err, data, ... प्रारूप (प्रतिक्रिया के बजाय) में होना चाहिए।

संक्षेप में, IMHO, _quick start_ एक ईमेल भेजने के लिए निम्न स्तर का कार्यान्वयन है। यह गहरी कार्यक्षमता के लिए उपयोगी हो सकता है, लेकिन निश्चित रूप से _quick start_ के लिए नहीं। 😁

अद्भुत सेवा और मॉड्यूल के लिए बहुत बहुत धन्यवाद। ✨

@IonicaBizau ,

बहुत बढ़िया प्रतिक्रिया, धन्यवाद!

हम निश्चित रूप से आपके विचारों का जिक्र करेंगे क्योंकि हम मेल हेल्पर की अगली यात्रा का निर्माण करते हैं।

आप सही हैं, यह पहला संस्करण एपीआई पर एक पतला आवरण है। यह योजना सामुदायिक फीडबैक के आधार पर धीरे-धीरे सुधार करने की है, जैसे आपने क्या किया है!

समुदाय को आपके समर्थन और योगदान के लिए, हम आपको कुछ स्वैग भेजना चाहते हैं। कृपया हमें अपनी टी-शर्ट के आकार और मेलिंग पते के साथ [email protected] पर एक ईमेल भेजें।

जैसा कि आप फिट देखते हैं, कृपया अतिरिक्त प्रतिक्रिया जोड़ने के लिए स्वतंत्र महसूस करें। एक बार फिर धन्यवाद!

@IonicaBizau

आप भी कुछ ऐसा कर सकते हैं:

var sg = require('sendgrid').SendGrid('API_KEY');
var request = sg.emptyRequest()

request.body = {
  "content": [
    {
      "type": "text/html",
      "value": "<html><p>Hello, world!</p></html>"
    }
  ],
  "from": {
    "email": "[email protected]",
    "name": "My Name"
  },
  "personalizations": [
    {
      "to": [
        {
          "email": "[email protected]",
          "name": "John Doe"
        }
      ]
    }
  ],
  "template_id": "TEMPLATE_ID",
};

request.method = 'POST'
request.path = '/v3/mail/send'
sg.API(request, function (response) {
  console.log(response.statusCode)
  console.log(response.body)
  console.log(response.headers)
});

मैं सहायक सिंटैक्स पर इस सिंटैक्स को पसंद करता हूं। उदाहरणों पर एक नज़र डालें, उन्होंने मेरी काफी मदद की।

https://github.com/sendgrid/sendgrid-nodejs/blob/master/examples/mail/mail.js

HTH

@thinkingsouble वाह! जरूर करेंगे। धन्यवाद-मदद करने में खुशी! 😁

@peterkuiper मैंने वह भी करने की कोशिश की, लेकिन मुझे लगता है कि मैंने text/html को html से बदलने की गलती की और सामग्री अनुलग्नक के रूप में दिखाई दी। फिर मैंने अभी संस्करण को डाउनग्रेड करने का निर्णय लिया।

लेकिन फिर से, यह अभी भी निम्न-स्तर ( request.method = ... , content सरणी में MIME प्रकार भेज रहा है, response कॉलबैक आदि में तर्क) दिखता है।

धन्यवाद @peterkuiper!

मैंने पिछले हफ्ते README में उदाहरण की शैली को जोड़ा :)

@IonicaBizau ,

हां, वह निम्न-स्तरीय सामान जल्द ही छिपा दिया जाएगा।

@thinkingsouble यह सुनकर खुश हो गया कि अनुरोध सामग्री जल्द ही छिपी होने वाली है glad

@IonicaBizau के महान सुझावों के बाद, एक और सिफारिश "निजीकरण" के कार्यान्वयन के विवरण को

var sg = require('sendgrid').SendGrid('API_KEY');
sg.addTo(x);
sg.addBcc(email);
sg.addBcc(email);
sg.addHeader(header);

एसडीके के माध्यम से विस्तार के इस स्तर को उजागर करना सिर्फ अनावश्यक लगता है।

इसके अलावा, निश्चित नहीं है कि यह पहले से ही एक विशेषता है, लेकिन इन कॉल को चेन करने में सक्षम होना बहुत अच्छा होगा:

var sg = require('sendgrid').SendGrid('API_KEY');
sg.addTo(x)
  .addBcc(email)
  .addBcc(email)
  .addHeader(header)
  .send();

धन्यवाद और अच्छा काम जारी रखें good

@jamesdixon ,

अतिरिक्त प्रतिक्रिया के लिए धन्यवाद!

जब तक हमें मेल हेल्पर को बढ़ाने के लिए कुछ और कार्यान्वयन को छुपाने में सक्षम नहीं हो जाता, तब तक @adambuczynski का कमाल का पुल अनुरोध देखें: https://github.com/sendgrid/sendgrid-nodejs/pull/261। यह सीधे आपके विशिष्ट विचार को संबोधित नहीं करता है, लेकिन यह सही दिशा में एक कदम है।

@thinkings रहस्यमय आप निम्न स्तर के अनुरोध का सामान जल्द ही छिपा देंगे, क्या आप लोगों को पहले से ही इसके लिए कुछ योजना बनाई गई है? मैं इसके बारे में कल सोच रहा था, और हालांकि यह कि पूरे एपीआई तक पहुंच के लिए अच्छा है, आप इसके लिए sendgrid-rest उपयोग कर सकते हैं। इस तरह, यह सब पुस्तकालय को करने की अनुमति है, आपको ईमेल भेजने की अनुमति है, और इस तरह केवल एपीआई भेजने वाले ईमेल को उजागर करें।

यह आप अलग-अलग चिंताएं थीं और इस पैकेज के फ़ोकस को थोड़ा संकीर्ण कर दिया, चेंजिंग के साथ क्लीनर एपीआई की अनुमति दी जैसे

@adambuczynski ,

हमारी योजना सहायकों के माध्यम से अमूर्त परत को निष्पादित करना है। मेल सबसे पहले है, लेकिन निकट भविष्य में हम सब्यूसर प्रबंधन और टेम्पलेट्स के लिए एक जोड़ने की योजना बनाते हैं। लेकिन पहले हमें मेल सहायक को चमकाने और इसे मानक बनाने की आवश्यकता है।

आप सही हैं, यह लाइब्रेरी सेंडग्रिड-रेस्ट के ऊपर सिर्फ एक बहुत पतली परत है और बस उदाहरण जोड़ता है, एक उपयोग फ़ाइल और यूनिट परीक्षण (ये सभी स्वचालित हैं (हम अपनी स्वैगर परिभाषा का उपयोग करके इस स्रोत को भी खोलने की उम्मीद कर रहे हैं)। दीर्घकालिक, हम सभी समापन बिंदुओं के लिए सहायक कोड लागू करने की कल्पना करते हैं, दोनों डेटा सत्यापन के साथ पूर्ण होते हैं, उस कार्यक्षमता के मूल के साथ स्वचालित भी। वर्कफ़्लोज़ और उपयोग के मामलों को हाथ से तैयार किया जाएगा।

अगले कुछ हफ्तों / महीनों में हम आगे की प्रतिक्रिया के लिए GitHub पर यहां रोडमैप को उजागर करेंगे।

इसके अलावा, अगस्त के अंत तक हम इस लाइब्रेरी में आने वाले पार्स वेबहूक के लिए समर्थन जोड़ देंगे।

इस प्रश्न को पूछने के लिए धन्यवाद और आशा है कि मेरे उत्तर से आपके और समुदाय की प्रतिक्रिया बढ़ेगी। हम चाहते हैं कि यह एक समुदाय संचालित पुस्तकालय हो, जिसका समर्थन और नेतृत्व SendGrid द्वारा किया जाए।

अपडेट @thinkingsouble के लिए धन्यवाद। मुझे आगे जाने वाले प्रांतीय नोडज पुस्तकालय में भूमिका निभाने में खुशी होगी।

आप इस स्तर पर पार्स समर्थन क्यों जोड़ रहे हैं? मुझे लगा कि अगले साल जनवरी में पार्स सेवा सेवानिवृत्त हो रही है।

@thinkingsouble मैं यह उल्लेख करना भूल गया कि अगर कुछ है तो मैं यहां मदद कर सकता हूं, बस मुझे पिंग करें। अगर मैं करने में सक्षम हूं तो मुझे चीजों को हैक करने में खुशी होगी। :मुस्कुराओ:

@adambuczynski यह बहुत अच्छी खबर है! साथ ही, आपका पुल अनुरोध शीर्ष के करीब हो रहा है। मैं सोच रहा हूं कि मैं इसे अगले सप्ताह के शुरू में विलय कर पाऊंगा।

पारसे के संबंध में, हमने आधिकारिक तौर पर अभी तक इसे रिटायर करने का फैसला नहीं किया है। पुस्तकालयों में समर्थन जोड़ना हमारे परीक्षण का हिस्सा है यह निर्धारित करने के लिए कि हम इसे जारी रखेंगे या नहीं।

@IonicaBizau ,

धन्यवाद! आपका समर्थन काफी सराहनिय है!

क्या मेल हेल्पर का उपयोग करके कई प्राप्तकर्ताओं को सेट करने का एक तरीका है?
मैंने देखा कि helper.Mail(from_email, subject, to_email, content) प्राप्तकर्ता को सेट करने के लिए personalization.addTo का उपयोग करता है .. मेरा मानना ​​है कि यह केवल 1 प्राप्तकर्ता के साथ काम करता है न कि प्राप्तकर्ताओं की एक सरणी (शायद मैं गलत हूं) और सहायक setTo प्रदान नहीं करता है

मुझे लगता है कि अगर मैं के साथ निजीकरण अपने आप को स्थापित करने थे let personalization = new helper.Personalization(); मैं कर सकता personalization.tos = [email, email]//email=new helper.Email(email_address, name) यह सुरक्षित है? क्या भविष्य के रिलीज में बदलाव की संभावना है?

@ अल्बर्ट-ए-निर्माता मैं इसका उपयोग इस प्रकार करता हूं:

  //Helpers
  const Mail = sendgrid.mail.Mail;
  const Email = sendgrid.mail.Email;
  const Personalization = sendgrid.mail.Personalization;

  //Create new mail object
  let mail = new Mail();

  //Create recipients
  let recipients = new Personalization();
  recipients.addTo(new Email(data.to, data.toname));

  //Set recipients
  mail.addPersonalization(recipients);

मुझे लगता है कि आप लूप में recipients.addTo लाइन को दोहराकर कई प्राप्तकर्ता जोड़ सकते हैं।

मुझे यह दृष्टिकोण काफी क्रियात्मक लगता है, ईमेल और निजीकरण कक्षाओं में विभाजित होने के साथ। कभी-कभी आप बस एक ईमेल पता जोड़ना चाहते हैं और इसे भेजना चाहते हैं, और ऐसा लगता है कि आपको इसे पूरा करने के लिए कोड की बहुत सारी लाइनों की आवश्यकता है।

@ अल्बर्ट-निर्माता,

वह रचनाकार लोगों को एकल ईमेल भेजने में मदद करने के लिए बनाया गया था, मूल रूप से यह एक "हैलो ईमेल" फ़ंक्शन है।

कई ईमेल के लिए, आप शायद इस उदाहरण का अनुसरण करना चाहते हैं (जैसा कि आप पहले से ही निजीकरण सेट करके इस पथ को शुरू कर चुके हैं): https://github.com/sendgrid/sendgrid-nodejs/blob/master/examac/helpers/mail /example.js#L15

निजीकरण के बारे में पढ़ना भी उपयोगी हो सकता है: https://sendgrid.com/docs/Classroom/Send/v3_Mail_Send/personalifications.html

सहायक निश्चित रूप से विकसित होगा, लेकिन किसी भी ब्रेकिंग परिवर्तन को एक प्रमुख बिंदु रिलीज के साथ सूचित किया जाएगा। मुझे हालांकि एपीआई में बदलाव की उम्मीद नहीं है।

@adambuczynski ,

में पिचिंग के लिए धन्यवाद! हमें इस तरह के अतिरिक्त सामान्य उपयोग के मामलों के लिए सहायक को अपडेट करने और उदाहरण के लिए टेम्प्लेट के साथ ईमेल भेजने की आवश्यकता है।

@ सहायकों की मदद करने वाला एपीआई एपीआई कुछ ऐसा था जिसे मैं फिर से समय देने पर संभवत:

@adambuczynski ,

यह बहुत बढ़िया है, जब आप उस पर शुरू करने का फैसला करते हैं, तो कृपया मुझे पिंग करें। या अगर हम आपके सामने शुरू करते हैं, तो मैं आपको पिंग करूंगा।

मैंने @bcootner द्वारा कोड का उपयोग किया और यह ठीक काम किया। हालाँकि, इस नोड प्लगइन के साथ टेम्पलेट का उपयोग कैसे करें, इसका उचित और आधिकारिक उदाहरण होना बहुत अच्छा होगा।

@otmezger ,

पालन ​​करने के लिए धन्यवाद!

मैं इस सप्ताह उस उदाहरण पर काम कर रहा हूं, आप इसे आरईएडीएमई से जुड़ा पाएंगे।

मैं टेम्प्लेट हेल्पर का उपयोग नहीं करता, लेकिन मैं HTML और पाठ प्रारूप दोनों टेम्प्लेट और भाग दोनों को एक सहायक load पद्धति के माध्यम से लोड करने के लिए अपना दृष्टिकोण साझा करूंगा:

  /**
   * Load an email (both plain text and html)
   */
  load(email, data, req) {

    //Get filenames
    const PARTIAL_HTML = path.resolve('./app/components/' + email + '.html');
    const PARTIAL_TEXT = path.resolve('./app/components/' + email + '.txt');

    //Append some globals
    if (req) {
      Object.assign(data, {
        app: {
          title: req.app.locals.APP_TITLE,
          version: req.app.locals.APP_VERSION,
          url: req.app.locals.APP_BASE_URL,
        },
        date: {
          year: moment().format('YYYY'),
          date: moment().format('DD-MM-YYYY'),
        },
      });
    }

    //Return promise
    return Promise.all([
      Promise.all([
        readFile(TEMPLATE_TEXT, 'utf8'),
        readFile(PARTIAL_TEXT, 'utf8'),
      ]).spread((template, partial) => {
        return template.replace('{{partial}}', partial);
      }),
      Promise.all([
        readFile(TEMPLATE_HTML, 'utf8'),
        readFile(PARTIAL_HTML, 'utf8'),
      ]).spread((template, partial) => {
        return template.replace('{{partial}}', partial);
      }),
    ]).then(result => result.map(contents => replaceData(contents, data)));
  },

इसके बाद Sendgrid के साथ उपयोग के लिए तैयार एक वस्तु प्राप्त करने के लिए इस प्रकार इस्तेमाल किया जा सकता है:

  let email = mailer.load('user/emails/verify-email-address', data, req)
    .spread((text, html) => ({
      to: user.email,
      from: req.app.locals.EMAIL_IDENTITY_NOREPLY,
      subject: 'Verify your email address',
      text, html,
    }));

आप आसानी से हैंडलबार्स की तरह कुछ का उपयोग करने के लिए उदाहरण का अनुकूलन कर सकते हैं। उपर्युक्त उदाहरण में replaceData सहायक एक सरल कार्य है जो डेटा प्रदान करने के साथ हैंडलबार जैसे टैग को प्रतिस्थापित करता है।

मुझे यकीन नहीं है कि यह प्रासंगिक है या नहीं, लेकिन "मेल हेल्पर" का उपयोग नहीं करके मैंने अपने आप को समय की एक असीम मात्रा में बचाया। यह इतना निराश हो जाने के बाद मैं 2.0 के उद्देश्य से डाउनग्रेड हो गया। मैं वैध V3 JSON उत्पन्न करने के लिए सिर्फ एक कारखाने-प्रकार के फ़ंक्शन का उपयोग कर रहा हूं और अब V3 एपीआई में सुधार पर बहुत उत्साहित हूं (क्योंकि मैं वास्तव में अब उनका उपयोग कर सकता हूं)।

यह एक ऐसी चीज है जिससे मैं पहले भी जूझता था। मुझे लगता है
सहायकों को संभवतः अधिक कुशल, और उपयोग में आसान बनाया जा सकता है। मैं
यहां तक ​​कि तर्क देते हैं कि शायद उन्हें मुख्य प्रेषक मॉड्यूल का हिस्सा नहीं होना चाहिए,
चिंताओं को अलग करने के लिए और लोगों को उनका उपयोग करने की अनुमति देने के लिए।

मैं उन पर एक और नजर डालूंगा और देखूंगा कि क्या मैं कुछ ठोस कर सकता हूं
सुझाव।

शुक्र पर, 26 अगस्त 2016, 05:48 शॉन लिंडो सूचनाएं @github.com ने लिखा:

मुझे यकीन नहीं है कि यह उदाहरण के द्वारा या नहीं, लेकिन "मेल सहायक" का उपयोग नहीं करके
मैंने अपने आप को समय की एक बड़ी मात्रा में बचाया। ऐसा होने के बाद है
निराश मैं उद्देश्य पर 2.0 से नीचे चला गया।

-
आप इसे प्राप्त कर रहे हैं क्योंकि आपका उल्लेख किया गया था।
इस ईमेल का उत्तर सीधे दें, इसे GitHub पर देखें
https://github.com/sendgrid/sendgrid-nodejs/issues/252#issuecomment -242479491
या धागा म्यूट करें
https://github.com/notifications/unsubscribe-auth/AAd8Qu5iRLFQwoKlRd2fP5oioT1uLqB6ks5qjdV2gaJpZM4AAiac
।

@ शीनलिंडो ,

कुछ प्रतिक्रिया देने के लिए समय निकालने के लिए धन्यवाद!

मेल हेल्पर के बिना इस पुस्तकालय का उपयोग करने का एक उदाहरण है: https://github.com/sendgrid/sendgrid-nodejs#without -mail-helper-class

मेल हेल्पर एक पहला संस्करण है और हम अगले संस्करण को बेहतर बनाने में आपकी मदद करने के लिए आपकी तरह प्रतिक्रिया पर निर्भर हैं। क्या आपको लगता है कि आपके द्वारा चलाए गए विशिष्ट मुद्दों को साझा करने के लिए हम उन्हें ठीक करने के लिए टिकट बना सकते हैं?

इसके अलावा, मैं कतार में जाने में मदद करने के लिए मेल हेल्पर को बेहतर बनाने के लिए अपने वोट को हमारे बैकलॉग कार्य में जोड़ रहा हूं। धन्यवाद!

@adambuczynski ,

मैं देख रहा हूँ कि आपका उत्साह जारी है :)

मैं आपकी प्रतिक्रिया की प्रतीक्षा कर रहा हूं, मुझे पता है कि यह बहुत अच्छा होगा!

@ जूल्सबौ ,

हमने एक USE_CASES.md फ़ाइल शुरू की है जहां हम आम उपयोग के मामलों के लिए उदाहरण प्रदान करेंगे। पहला लेनदेन टेम्प्लेट था :)

मैं आपकी प्रतिक्रिया की प्रतीक्षा कर रहा हूं, मुझे पता है कि यह बहुत अच्छा होगा!

👻

@ निश्चयबुद्धि ! मुझे एक या दो दिन दीजिए और मैं आपको एक ठोस उदाहरण प्रदान करूँगा।

यह मेरे पसंदीदा धागे में से एक है :)

मुझे लगता है कि इस पुस्तकालय के अगले पुनरावृत्ति के लिए आपकी प्रतिक्रिया महत्वपूर्ण होने वाली है, जो संभवतः एक परिवर्तन को तोड़ने वाला होगा। यदि आपके पास एक पल है, तो क्या आप हमारे प्रस्ताव पर एक नज़र डाल सकते हैं? https://github.com/sendgrid/sendgrid-nodejs/issues/290

धन्यवाद!

@thinkingsouble मुझे आखिर समझ में आ गया कि v3 में पेश किए गए सभी Sendgrid हेल्पर वर्गों के बारे में मुझे क्या परेशान करता है ... उनमें से बहुत सारे हैं और वे ईमेल को अनावश्यक रूप से जटिल बनाते हैं: P

मैं Sendgrid के सभी कोड को ओवरहाल नहीं करना चाहता था, इसलिए मैंने इसके बजाय एक साधारण आवरण भेजने का फैसला किया, sendgrid-mailer ।

हालांकि Sendgrid की सहायक कक्षाएं पर्दे के पीछे उपयोगी हैं, ईमेल मॉडल बनाने और मान्य करने के लिए, मुझे नहीं लगता कि उन्हें केवल एपीआई के साथ बातचीत करने के लिए हमें मजबूर किया जाना चाहिए। मुझे लगता है कि इसे लिखने से नोड ऐप्स को अधिक जटिल होना चाहिए, और सहायकों का नामकरण काफी भ्रामक हो सकता है, जैसे Mail vs Email ।

मुझे लगता है कि मूल उदाहरण समस्या को अच्छी तरह दिखाता है:

https://github.com/sendgrid/sendgrid-nodejs#with -mail-helper-class

यह सिर्फ "मैं एक ईमेल भेजना चाहता हूँ" के रूप में बुनियादी कुछ के लिए बहुत जटिल तरीका लगता है। इससे आपको ईमेल भेजने से पहले 8 अलग-अलग निर्भरताओं को लोड करने और कोड की 15 लाइनें लिखने की आवश्यकता होती है।

सहायक वर्गों का उपयोग न करना यकीनन और भी बुरा है, हालांकि तब आपको ईमेल JSON अनुरोध की आवश्यक संरचना को जानना होगा और इसे सही ढंग से अपने आप में बदलना होगा। एक गलती आसानी से अनुरोध को तोड़ देगी।

इसलिए मैंने एपीआई हेल्पर का उपयोग करने के लिए एक सरल, आसान के पीछे सभी सहायक वर्गों के तर्क को अलग कर दिया, ताकि Sendgrid के साथ ईमेल भेजना आसान और मज़ेदार हो जाए :)

सबसे बुनियादी उदाहरण बन जाता है:

//Load mailer and set API key (only needed once)
const mailer = require('sendgrid-mailer').config(API_KEY);

//Create email data 
const email = {
  to: '[email protected]',
  from: 'Someone <[email protected]>',
  subject: 'Hello world',
  text: 'Hello plain world!',
  html: '<p>Hello HTML world!</p>',
};

//Send away 
mailer.send(email); //Returns promise 

अनुरोध का निर्माण पर्दे के पीछे किया गया है और Sendgrid के सहायकों का पारदर्शी रूप से उपयोग करता है।

यह कई ईमेल भेजने का भी समर्थन करता है, अगर आगे अनुकूलन की आवश्यकता है तो Sendgrid ऑब्जेक्ट को उजागर करता है, साथ ही Sendgrid Mail इंस्टेंस को स्वीकार करता है, और / से फ़ील्ड्स के लिए / जैसे Name <[email protected]> लिए कई प्रकार के प्रारूप स्वीकार करता है। नाम या ईमेल गुणों के साथ README देखें।

वहाँ शायद अभी भी सुधार के लिए जगह है, लेकिन मैं इस समाधान को यहाँ साझा करना चाहता था, जिससे लोग Sendgrid API का उपयोग करना चाहते थे, वह इससे अभिभूत हुए बिना नहीं था।

आशा है कि यह किसी के लिए काम आता है, और शायद यह इस पुस्तकालय के भविष्य के लिए कुछ दिशा प्रदान कर सकता है, एक सरल एपीआई को उजागर करने में :)

cc @julesbou थोड़ी देर से, लेकिन मुझे आशा है कि आप अभी भी इसके लिए एक उपयोग पा सकते हैं।

@adamreisnz गंभीरता से, धन्यवाद।

मेरा बैकग्राउंड जॉब जो सेंडग्रिड के जरिए ईमेल भेजता है, v4.0.7 का उपयोग कर रहा था, जो पहले से ही काफी जटिल था। मैंने नवीनतम संस्करण में अपग्रेड किया और दुख की बात है कि सब कुछ टूट गया। मैं इस बात से बहुत निराश था कि ईमेल भेजना कितना जटिल था, जिसे मैंने अपडेट करने की जहमत नहीं उठाई।

उस सब ने कहा, इस बात की सरलता वही है जो मैं खोज रहा था। मैं इसे सप्ताहांत में एक शॉट दूँगा।

चियर्स!

@jamesdixon मैं अभी भी v3.xx पर अटका हुआ था और अपग्रेड नहीं करना चाहता था :)

उम्मीद है कि आप इसे उपयोगी पाएंगे। मुझे पता है कि यह आपके लिए कैसे काम करता है और अगर कुछ भी महत्वपूर्ण गायब है, धन्यवाद!

@adamreisnz ,

यह हमारे समुदाय के साथ साझा करने के लिए भयानक और धन्यवाद है :)

tldr; हमारे सहायक वर्ग समाप्त नहीं हुए हैं और आप पहले ही हमें हरा चुके हैं जहाँ हम जा रहे हैं :)

हम आपके विचारों से पूरी तरह सहमत हैं और यह v3 लाइब्रेरी अपडेट का चरण है जो हम वर्तमान में अपने सभी 7 एसडीके में काम कर रहे हैं। कृपया Node.js परियोजना पर अधिक विस्तार के लिए यहां मेल हेल्पर संवर्धन परियोजना देखें।

वर्तमान में, हम C # लाइब्रेरी को पूरा कर रहे हैं। क्या हम इस Node.js पुस्तकालय के लिए योजना का एक ठोस उदाहरण प्राप्त करने के लिए, कृपया देखें इस । हम उम्मीद कर रहे हैं कि एक ही दिन में रिलीज होगी।

तो, मेरे पास एक प्रस्ताव है:

क्या आप यहाँ मेल हेल्पर में अपना समाधान जोड़ना चाहेंगे (जैसा हमने C # में किया है)? मुझे लगता है कि आपका काम उस मामले में एक बड़ी पहुंच हासिल करेगा। यदि नहीं, तो कोई बात नहीं। चूंकि आपने एमआईटी लाइसेंस के तहत अपनी परियोजना पोस्ट की है, मुझे उम्मीद है कि अगर आप अपने अच्छे काम से थोड़ा उधार लेते हैं तो आप हमें माफ कर देंगे;) और निश्चित रूप से, हम यह सुनिश्चित करेंगे कि आपको अपने योगदानों के लिए श्रेय मिले।

आप अपने काम को अलग रखने का फैसला करते हैं, तो आप एक लिंक जोड़ने कृपया सकता है यहां सामुदायिक पुस्तकालय धारा के तहत?

आपके अद्भुत निरंतर समर्थन के लिए धन्यवाद। आपने धमाल मचाया!

@ सुनकर खुशी हुई कि आप भी ऐसा ही सोच रहे हैं। सी # उदाहरण बेहतर दिखता है, लेकिन मुझे लगता है कि जेएस कार्यान्वयन के लिए अभी भी कुछ हद तक जटिल है। जेएस में जाने के लिए हमेशा सब कुछ बनाना जरूरी नहीं है।

आपके प्रस्ताव के लिए, चूंकि मैं अभी भी हुड के नीचे सहायक वर्गों का उपयोग कर रहा हूं, इसलिए मुझे नहीं पता कि यह वास्तव में आधिकारिक पुस्तकालय में पोर्ट करने के लिए कितना उपयोगी होगा। मैं शायद एक बड़े पुनर्लेखन (जैसे वी 5) के साथ मदद करने के लिए और नए सिरे से शुरू करने के लिए इच्छुक हूं, उपयोगकर्ताओं और नोड समुदाय से इनपुट ले सकता हूं और एक भयानक एपीआई के साथ आऊंगा जो कि जरूरत पड़ने पर अभी तक लचीला उपयोग करने के लिए दोनों आसान है।

लेकिन अगर इस समय में आप आधिकारिक रैपर में उपयोग करने के लिए मेरे रैपर से कुछ कोड उधार लेना चाहते हैं, तो हर तरह से इसके लिए जाएं :) मैं उस पेज में अपने रैपर से लिंक जोड़ूंगा time

मुझे वास्तव में लगता है कि परियोजना को दो पैकेजों में विभाजित करना एक अच्छा विचार हो सकता है, एक निम्न स्तर जिसमें एपीआई के साथ बातचीत के लिए अनुरोध तर्क शामिल है, और एक उच्च स्तर सिर्फ ईमेल भेजने के लिए, जैसा मैंने बनाया है।

निचले स्तर के पैकेज का उपयोग लोगों को एपीआई तक पूर्ण पहुंच की आवश्यकता के लिए किया जा सकता है, जबकि मेलर पैकेज केवल ईमेल भेजने के इच्छुक लोगों के लिए उपयुक्त होगा। और निश्चित रूप से हुड के तहत, मेलर एपीआई पैकेज का उपयोग करेगा।

@thinkingserious कि पर अपने विचार क्या हैं?

@adamreisnz ,

हमेशा की तरह विचारशील प्रतिक्रिया के लिए धन्यवाद।

मुझे यकीन नहीं है कि अगर हमें इस बिंदु पर परियोजना को विभाजित करने की आवश्यकता है। मुझे लगता है कि हम वर्तमान सहायक मॉडल के साथ समान परिणाम प्राप्त कर सकते हैं। उस ने कहा, मैं भविष्य के संस्करण में एक नई वास्तुकला की खोज करने के लिए तैयार हूं और मैं आपको इसके लिए बोर्ड पर रखना पसंद करूंगा।

उम्मीद है कि समुदाय के कुछ अन्य लोग इसमें वजन करेंगे।

मैं इस पर गहराई से सोचूंगा और अपडेट किए गए मेल हेल्पर को लागू करने का समय आने पर इसे फिर से संलग्न करूंगा।

आपके समर्थन के लिए और हमारे डॉक्स के लिए लिंक जोड़ने के लिए फिर से धन्यवाद!

यह चिंताओं को अलग करने की बात है। आप मुख्य पुस्तकालय के अंदर आसान मेलिंग के लिए एक सहायक / रैपर को शामिल कर सकते हैं, लेकिन मेरी राय में दोनों के संभावित अवरोध या अनावश्यक जटिलता के लिए दो अलग-अलग चिंताओं का मिश्रण है। उन्हें अलग-अलग रखने से उपभोक्ताओं को उनकी (या दोनों) ज़रूरत वाली लाइब्रेरी को चुनने की अनुमति मिलेगी, और स्पष्ट रूप से परिभाषित सीमाओं के कारण दोनों पुस्तकालयों के विकास को आसान बना देगा।

मुझे लगता है कि यह नोड और एनपीएम मॉड्यूल की प्रकृति है जितना संभव हो उतना चिंताओं को अलग करना, और प्रत्येक पैकेज को एक विशिष्ट कार्य करना है (और इसमें अच्छा हो!)। जब मैंने पहली बार नोड के साथ शुरुआत की थी तो यह कुछ ऐसा था जिसकी मुझे आदत थी, लेकिन एक बार मैंने ऐसा किया, तो मुझे स्वच्छ, सरल पैकेज विकसित करने की स्वतंत्रता और क्षमता पसंद आई।

समुदाय से कुछ टिप्पणियों को सुनने के लिए तत्पर रहें।

ठीक है, आप निश्चित रूप से एक ठोस तर्क के साथ प्रेरक हैं :)

मैं वास्तव में आपको समय देने के लिए सराहना करता हूं।

मैं पहले से ही इस पुस्तकालय में काम करने के लिए वापस आने के लिए उत्सुक था और अब आप मुझे इस एसडीके पर आपके और समुदाय के साथ काम करने के लिए वास्तव में उत्साहित कर रहे हैं।

महान, मुझे पता है जब आप इस पर काम करने जा रहे हैं :)
मैं 4 हफ्तों के लिए छुट्टी ताकि साधन मैं अंत में अच्छी तरह से ओपन सोर्स प्रोजेक्ट पर कुछ काम करने के लिए कुछ खाली समय होगा पर हूँ 🌴

@adamreisnz ,

मुबारक हो!

एक उच्च स्तर "मेलर पैकेज" वास्तव में हम क्या चाहते हैं। बस कुछ ईमेल भेजने की जरूरत है।

अंतिम संस्करण के साथ यह मृत सरल था, और अब यह एक अपवित्र गड़बड़ है। "बेसिक" उदाहरण में वर्तमान में 8 संस्करण परिभाषित हैं , जिनके लिए विशेष निर्माणकर्ताओं की आवश्यकता होती है। उपयोग में आसानी के मामले में विशाल कदम पीछे।

जितना सरल होना चाहिए

sendgrid.send({
  from: fromEmail,
  fromName: fromName,
  to: toEmail,
  subject: 'Hello'
  ...
})
.then(...)
.catch(...)
.finally(...)

शून्य डॉक्स की जरूरत है, बस एक उदाहरण हम पेस्ट और हमारे रास्ते पर कॉपी कर सकते हैं। यह हमारी टीम के लिए SendGrid का प्राथमिक मूल्य है, और दुर्भाग्य से यह अब गायब है।

@eeosk की नज़र https://github.com/sendgrid/sendgrid-nodejs/issues/252#issuecomment -265934147 a पर है

@adamreisnz बहुत अच्छा लग रहा है; बहुत स्पष्ट डिजाइन निर्णय। मुझे आशा है कि आप SendGrid पेरोल पर हैं!

@thinkingsouble कृपया मुख्य डॉक्स को @adamreisnz प्रोजेक्ट को इंगित करने पर गंभीरता से विचार करें, क्योंकि यह सब कुछ काफी सरल करता है, और अगर मैं आज इसके बारे में पहले से जानता था, तो यह मुझे घंटों सिरदर्द से बचाने में मदद करता था कि कौन-सा आइन्डो एक अतिरंजित है, जावा- जेएस में प्रेरित एपी। कृपया अपने उपयोगकर्ताओं को वे दें जो वे चाहते हैं, न कि आप जो सोचते हैं कि वे चाहते हैं :-)

इसके अलावा, बस ध्यान दें कि मुझे आश्चर्य नहीं होगा यदि अन्य देवता यहां अधिक बार समाप्त होने लगते हैं कि अब V2 एपीआई सूर्यास्त हो गया है, और नए खातों को वी 3 एपीआई का उपयोग करने के लिए मजबूर किया जाएगा। व्यक्तिगत रूप से, मैंने जो पहली कोशिश की थी वह नोडमैलर का उपयोग कर रहा था (जिसका प्रेषित परिवहन अभी भी w / v2 काम करता है) जो कि अतीत में दर्जनों परियोजनाओं के लिए समझ में आया है, लेकिन इस समय के आसपास काम पाने के लिए हमेशा के लिए ले लिया। अगर मुझे नोड समुदाय में नोडेमैलर की लोकप्रियता को देखते हुए अनुमान लगाना होता है, तो मैं केवल वही नहीं रहूंगा जो आने वाले महीनों में इस तरह से महसूस कर रहा है।

आपकी प्रतिक्रिया के लिए @ fisch0920 धन्यवाद, मैं Sendgrid API को बेहतर बनाने के लिए आने वाले हफ्तों में @thinkings रहस्यमय के साथ मिलकर काम करूंगा। उम्मीद है कि हम एक ऐसी चीज़ लेकर आएंगे जिसका उपयोग करना आसान है लेकिन फिर भी ज़रूरत पड़ने पर पर्याप्त लचीला है।

सभी को नमस्कार,

मुझे लगा कि आप SendGrid Node.js मेल हेल्पर पर फिर से डिजाइन में रुचि रख सकते हैं: https://github.com/sendgrid/sendgrid-nodejs/pull/378

आपकी प्रतिक्रिया की बहुत सराहना की जाएगी!

शुभकामनाएं,

एल्मर

कृपया अपडेट के लिए # 378 पर जाएँ, धन्यवाद!