डेटा स्रोत और एपीआई

Sendtric API के साथ डेटा स्रोत में रिकॉर्ड कैसे भेजें

अंतिम अपडेट

API डेटा स्रोत के साथ, आपका अपना सिस्टम जब भी आपका डेटा बदलता है, Sendtric को JSON रिकॉर्ड भेजता है। Sendtric उन्हें होस्टेड डेटा के रूप में संग्रहीत करता है, और जब कोई ईमेल खोला जाता है, तो आपका सिस्टम प्रत्येक सब्सक्राइबर का रिकॉर्ड देखता है।

यह मार्गदर्शिका उन लोगों के लिए है जो वह कोड लिखते हैं जो डेटा भेजता है। यदि आप चाहें कि Sendtric प्रत्येक ओपन पर आपकी API से डेटा प्राप्त करे, तो देखें डेटा स्रोत को अपनी API से कैसे कनेक्ट करें.

डेटा स्रोत बनाएँ

  1. बाएँ साइडबार में, क्लिक करें डेटा स्रोत, फिर नया डेटा स्रोत.
  2. के अंतर्गत एपीआई, चुनें एपीआई और क्लिक करें जारी रखें.
  3. चुनें Sendtric को डेटा भेजें और क्लिक करें जारी रखें.
  4. भरें:
    • डेटा स्रोत का नाम: उदाहरण के लिए "लॉयल्टी सदस्य"।
    • अद्वितीय पहचानकर्ता फ़ील्ड: वह JSON फ़ील्ड जो प्रत्येक रिकॉर्ड की पहचान करती है, जैसे customer_id या email. प्रत्येक रिकॉर्ड जिसे आप भेजते हैं उसमें यह शामिल होना चाहिए।
    • विवरण (वैकल्पिक).
  5. क्लिक करें डेटा स्रोत सहेजें. डेटा स्रोत बनाया गया है और एपीआई चरण आपके एंडपॉइंट्स और API कुंजी दिखाता है।
  6. जो आपको चाहिए उसे कॉपी करें, फिर क्लिक करें जारी रखें पूरा करने के लिए।
एक नए डेटा स्रोत का API चरण जो सिंगल-रिकॉर्ड और बल्क अपसेर्ट एंडपॉइंट्स, API कुंजी और उदाहरण अनुरोधों को दिखाता है।

आप डेटा स्रोत के एंडपॉइंट्स को किसी भी समय फिर से पा सकते हैं। एपीआई विवरण टैब पर।

प्रमाणिक करें

अपनी कुंजी भेजें Authorization प्रत्येक अनुरोध के हेडर में:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

द डेटा स्रोत एपीआई कुंजी केवल डेटा-सोर्स रिकॉर्ड भेजने के लिए काम करता है, इसलिए इसे डेवलपर या ऑटोमेशन टूल को देना सुरक्षित है। यदि आप API प्लान पर हैं, तो आपकी मौजूदा API प्लान कुंजी इन एंडपॉइंट्स पर भी काम करती है।

अपनी कुंजी को फ्रंट-एंड कोड और सार्वजनिक रिपॉजिटरी से दूर रखें। यदि यह कभी उजागर हो जाए, तो इसे के अंतर्गत पुनः उत्पन्न करें सेटिंग्स → एपीआई कुंजियाँ → डेटा स्रोत एपीआई कुंजी, फिर इसे उपयोग करने वाली सभी चीज़ों को अपडेट करें।

रिकॉर्ड बनाएँ या अपडेट करें

Sendtric में दिखाए गए एंडपॉइंट पर एक JSON ऑब्जेक्ट या ऑब्जेक्ट्स की एक ऐरे पोस्ट करें। एक रिकॉर्ड:

POST <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "customer_id": "CUST_1001",
  "first_name": "Sarah",
  "points": 1250
}

एक ही अनुरोध में कई रिकॉर्ड:

POST <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[
  { "customer_id": "CUST_1001", "first_name": "Sarah", "points": 1250 },
  { "customer_id": "CUST_1002", "first_name": "James", "points": 300 }
]

रिकॉर्ड्स कैसे सहेजे जाते हैं:

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

एक सफल अनुरोध लौटाता है 200 एक संक्षिप्त सारांश के साथ, उदाहरण के लिए {"status":"ok","records":2}.

आप एक रिकॉर्ड के अंदर ऑब्जेक्ट्स को नेस्ट कर सकते हैं, उदाहरण के लिए "address": { "city": "Leeds" }, और इमेज एडिटर में नेस्टेड फ़ील्ड्स चुन सकते हैं।

रिकॉर्ड हटाएँ

एंडपॉइंट के अंत में इसके पहचानकर्ता को जोड़कर एक रिकॉर्ड हटाएँ:

DELETE <your data source endpoint>/cust_1001
Authorization: Bearer YOUR_API_KEY

आईडी की एक ऐरे भेजकर कई को हटाएं:

DELETE <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

["cust_1001", "cust_1002"]

सीमाएँ

सीमामूल्य
प्रत्येक अनुरोध पर रिकॉर्डदस,०००
आकार का अनुरोध10 एमबी
पहचानकर्ता मान255 अक्षर
कोई भी एकल पाठ मान10 किलोबाइट
घोंसले की गहराई20 स्तर

प्रत्येक रिकॉर्ड के लिए एक अनुरोध भेजने के बजाय रिकॉर्ड बैचों में भेजें। हजारों रिकॉर्ड के लिए देखें डेटा स्रोत को बड़ी मात्रा में डेटा कैसे भेजें.

प्रतिक्रियाएँ और त्रुटियाँ

स्थितिइसका क्या मतलब हैक्या करें
दो सौरिकॉर्ड स्वीकार किए गएकुछ नहीं। यदि कुछ रिकॉर्ड्स छूट गए हों, तो X-Skipped-Records हेडर बताता है कि कितने।
चार सौयह JSON मान्य नहीं है।रिक्वेस्ट बॉडी की जाँच करें
चार सौ एकगैर-मौजूद या गलत एपीआई कुंजीअधिकृतकरण हेडर की जाँच करें
404इस कुंजी के लिए डेटा स्रोत नहीं मिला।एंडपॉइंट की जाँच करें और सुनिश्चित करें कि कुंजी उसी खाते की है।
चार सौ तेरहबहुत सारे रिकॉर्ड या बहुत बड़ेअनुरोध को छोटे-छोटे बैचों में विभाजित करें।
चार सौ बाईसकोई रिकॉर्ड सहेजा नहीं जा सका।यह संदेश उन रिकॉर्ड्स की सूची देता है जिनमें पहचान क्षेत्र (identifier field) नहीं है या जो बहुत बड़े हैं।
पचास तीनसेंड्ट्रिक व्यस्त हैRetry-After हेडर में दिए गए सेकंडों की संख्या तक प्रतीक्षा करें, फिर वही अनुरोध फिर से भेजें।

जब किसी अनुरोध में केवल कुछ रिकॉर्ड अमान्य होते हैं, तो मान्य रिकॉर्ड फिर भी सहेजे जाते हैं और बाकी को छोड़ दिया जाता है।

अपने रिकॉर्ड्स की जाँच करें

डेटा स्रोत खोलें और पर जाएँ रिकॉर्ड्स टैब पर जाएँ। पहचानकर्ता मान के अनुसार खोजें और संपूर्ण संग्रहीत JSON देखने के लिए किसी रिकॉर्ड पर क्लिक करें।

अगला कदम

क्या यह लेख उपयोगी रहा?

ज़ूम करने के लिए छवि पर क्लिक करें। आसपास देखने के लिए खींचें या स्क्रॉल करें।