API
कोनो निजी एंडपॉइंट नहि अछि। इंटरफ़ेस क' ल'ल सेहो नहि।
अधिकांश उत्पादन मे दूटक API होइत अछि: दस्तावेज़ित एकटा जाहि के अहाँका द'ल ग'ल अछि, आ रोचक दोसर एकटा जाहि क' ओकर अपन स्क्रीन उपयोग करैत अछि। दोसर सदा बेहतर होइत अछि, आ अहाँका ओकर नज़दीक कखनो नहि जाए द'ल जाइत अछि। एतय एकटा अछि, आ इंटरफ़ेस ओकर एकटा क्लाइंट अछि, अन्य कोनो चीज़ क' तरह — ई हमर स' एकटा बाधा अछि, आ ई कारण अछि जे अहाँ जे बनाबै चाहैत छी सब बनाबै सकल जाइत अछि।
ई नियम वास्तव मे की खर्च करैत अछि
एकर अर्थ अछि जे कखनो-कखनो स्क्रीन क' API के सही होए क' प्रतीक्षा करबाक पड़ैत अछि, एकटा सुविधाजनक फ़ील्ड क' ल'ल ओकर चारों ओर स' नहि। जहिया कोनो स्क्रीन क' ऐसन चीज़ चाही जे सार्वजनिक API नहि द' सकैत, ओहि दिन API गलत अछि, आ समाधान API ही अछि।
इसका लाभ अछि जे तीन बहुत भिन्न क्लाइंट क' लगभग कोनो अतिरिक्त लागत नहि होइत। MCP सर्वर एकटा क्लाइंट अछि। dash-b टाइल एकटा क्लाइंट अछि। अहाँक अपन स्क्रिप्ट एकटा क्लाइंट अछि। ओहि मे स' कोनो द्वितीय श्रेणी के नागरिक नहि अछि जे किएक-तँ अहाँक ल'ल बनाओल ग'ल सतह के चारों ओर काम करैत अछि, किएक-तँ दोसर कोनो सतह नहि अछि जाहि के दोसर मानल जाए।
दस्तावेज़ित, आ परखल ग'ल
OpenAPI /docs पर उत्पन्न होइत अछि आ प्रत्येक रूट के एकटा परीक्षण अछि जे दस्तावेज़ मे द'ल ग'ल उदाहरण अछि। कोड स' अलग लिखल ग'ल दस्तावेज़ एक महीना मे भटकि जाइत अछि; गलत होए पर बिल्ड विफल करए वाला दस्तावेज़ नहि भटकैत।
साइन इन करब
अहाँक castomo खाता, PKCE के साथ authorization code flow के माध्यम स' — वही खाता जे अहाँ dash-b आ परिवार के बाकी सब मे उपयोग करैत छी। अपन कोनो सर्वर नै भ'ल पृष्ठ ई फ़्लो बखूबी चला सकैत अछि; ई त' ओहि फ़्लो क' बनाबै के उद्देश्य ही छल। मशीन-स'-मशीन काम क' ल'ल, प्रोजेक्ट-स्कोप्ड API कुंजी।
- 1लोक
/v1/contacts·/lists·/segments·/tags·/imports - 2सामग्री
/v1/creatives, प्रत्येक लक्ष्य क' ल'ल सत्यापन, पूर्वावलोकन आ रेंडर के साथ - 3स्वचालन
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4प्रसारण
/v1/campaigns, दर्शक, सामग्री बनाब, शेड्यूल आ भेजब अलग-अलग चरण के रूप मे - 5घटनासभ भीतर
/v1/events— अहाँक अपन एप्लिकेशन के घटनासभ, ट्रिगर के रूप मे - 6वितरण
/sender-identities·/domains·/apps·/webhooks - 7संख्या
/v1/reports/*, आ ट्रैकिंग होस्ट पर/track/*
/docs पर OpenAPIएहि वही प्रक्रिया पर /mcp
परंपरासभ
हर दोसर castomo सेवा जहिन वही आकार
जे सुनै मे जतना अछि त' स' अधिक महत्वपूर्ण अछि। यदि अहाँ पहिने स' एहि मे स' कोनो एकटा क' कॉल करैत छी, त' अहाँ एहि के कोना उत्तर दैत अछि, विफल होइत अछि आ पृष्ठभूमि दैत अछि, ई पहिने स' जानैत छी।
एकटा त्रुटि एनवेलप
प्रत्येक विफलता के वही आकार अछि, एकटा स्थिर कोड आ व्यक्ति क' ल'ल अभिप्रेत संदेश। कोनो रूट अपन असंतोष व्यक्त करबाक अपन तरीका नहि बनबैत।
कर्सर पृष्ठभूमि
ऑफ़सेट नहि। अहाँ ओकरा पढ़ैत बखत बदलै वाला सूची चुपचाप पंक्ति छोड़ैत वा दोहराबैत नहि, जे ऑफ़सेट पृष्ठभूमि चुपचाप आ लगातार करैत अछि।
इडेम्पोटेंसी कुंजी
प्रत्येक परिवर्तनकारी रूट पर। जे अनुरोध अहाँ निश्चित नहि छी जे पहुँचल, ओकरा फिर स' भेजि आ वही उत्तर पाओ, दोसर संपर्क, दोसर अभियान वा दोसर भेजल नहि।
प्रोजेक्ट क' ल'ल स्कोप्ड
एकटा टोकन एकटा टेनेंट आ एकटा प्रोजेक्ट, दूनू क' संबोधित करैत अछि। पंक्ति-स्तरीय सुरक्षा डेटाबेस मे ही लागू होइत अछि, कोनो खंड जोड़बाक याद राखै स' नहि।
वेबहुक बाहर
हस्ताक्षरित, बैकऑफ़ के साथ फिर स' प्रयास क'ल, आ कम स' कम एक बेर वितरित — त' अहाँक एंडपॉइंट सेहो इडेम्पोटेंट ह'बाक चाही। घटनासभ वही शब्दावली अछि जे रिपोर्ट उपयोग करैत अछि।
मेटानय आ निर्यात
एकटा संपर्क API के माध्यमसँ निर्यात वा मेटाओल जा सकैत अछि, आ एकटा मेटानय परिवारक अपन आंतरिक मार्गसँ ओहि प्रतिलिपि राखनिहार प्रत्येक सहोदर सेवा तक पहुँचैत अछि।
इंटरफेस जे किछु क' सकैत अछि, एकटा POST सेहो ओहि सब क' सकैत अछि।
घटनासभ ई रोचक हिस्सा अछि
एहि पृष्ठ पर बाकी सब जे अछि, ओहि जका प्लंबिंग अछि जे अहाँ आशा करैत छी। POST /v1/events ओहि मार्ग अछि जे ई उत्पाद की लेल अछि सेहो बदलि दैत अछि।
अहाँक आवेदन एहन बात जानैत अछि जे कोनो मार्केटिंग टूल देखि नै सकैत अछि: के ऑनबोर्डिंग पूरा केलक, के सहकर्मीकेँ आमंत्रित केलक, के सीमा भेटल, के रविवार अपराह्न अपन डेटा निर्यात केलक। अहाँक अपन टोकन संग ओहि सब घटनाक रूपमे पोस्ट करू, आ प्रत्येक एकटा ट्रिगर, एकटा शर्त आ एकटा सेगमेंट बनि जाएत।
बाकी सब संपर्क मॉडलसँ निकलैत अछि। घटनासभ जोड़ल जाइत अछि, कखनो संपादित नै; ओहि सम्पूर्ण उत्पाद जे लॉग पर टिकल अछि, ओहि छी। अहाँक परिभाषित केल घटना पर ट्रिगर होएवाला फ़नल कोनो इंटीग्रेशन नै — ओहि वही तंत्र अछि जे message_opened उपयोग करैत अछि, बस भिन्न नाम संग।
- 1अहाँ ओहि पोस्ट करैत छी
POST /v1/events— एकटा नाम, एकटा संपर्क, एकटा पेलोड, एकटा आइडेंपोटेंसी कुंजी। - 2ओहि पहुँचैत अछिसंपर्कक लॉग मे जोड़ल जाइत अछि। अन्य किछु केँ एहि अस्तित्व जानब आवश्यक नै अछि।
- 3एकटा फ़नल शुरू होइत अछिजे कोनो फ़नलक प्रवेश ओहि घटनाक नाम लैत अछि, ओहि प्रवेश विनिर्देशक अंतर्गत पात्र प्रत्येक संपर्क लेल।
- 4अन्य फ़नलसभ ओहि पर शाखा करैत अछि"की ई घटना पिछला 14 दिन मे भेल अछि" एकटा साधारण सेगमेंट विधेय अछि।
- iआ ओहि रन समाप्त करैत अछिएहि घटनाक नाम लेनिहार एकटा लक्ष्य नोड व्यक्ति ओहि काज करैत ही उक्त क्रम रोकि दैत अछि।
अहाँक शब्दावलीअहाँक टोकन
निर्माण करबा सँ पहिने जानब लायक सीमासभ
ClickSomo अहाँक बारे मे तीन पहचानकर्ता राखैत अछि — एकटा टेनेंट, एकटा प्रोजेक्ट आ एकटा उपयोगकर्ता, अपारदर्शी आईडीक रूपमे — आ अन्य किछु नै। कोनो पासवर्ड नै, कोनो प्रोफ़ाइल नै, कोनो कार्ड नै, कोनो चालान नै। योजना सीमा संख्याक रूपमे आबैत अछि: कतेक संपर्क, कतेक प्रेषण, कतेक पीढ़ी। भुगतान शब्दावली ओहि रेखा पार नै करैत अछि, कोनो दिशा मे नै।
अहाँक संपर्क अहाँक अपन अछि। अहाँ डेटा नियंत्रक छी; हम आयोगी छी। एहन कोनो मार्ग नै जाहिसँ परिवारक अन्य उत्पाद अहाँक संपर्क सूची पढ़ि वा लिखि सकू, आ एकटा लेल उपयोग करबाक कोनो इनजेस्ट लेन नै अछि।
यदि अहाँ एहिकेँ गंभीर रूपसँ मूल्यांकन करि रहल छी: ई वेबसाइटक आओर किछु पढ़बा सँ पहिने /docs पढ़ू। API ई उत्पाद की करैत अछि सेहो ईमानदार विवरण अछि, आ एहि पृष्ठसभ पर दिएल प्रत्येक दावा ओतय उपलब्ध कोनो मार्ग वा नोड प्रकार सँ मेल खाइत अछि। जखन स्कीमा बदलैत अछि, ई पृष्ठसभ सेहो बदलैत अछि।