API

कोणताही खाजगी एंडपॉइंट नाही. इंटरफेससाठीही नाही.

बहुतेक उत्पादनांकडे दोन API असतात: तुम्हाला दिलेला प्रलंबित एक, आणि त्यांच्या स्वतःच्या स्क्रीन वापरणारा मनोरंजक दुसरा. दुसरा नेहमी चांगला असतो, आणि तुम्हाला त्याच्या जवळ जाण्याची परवानगी कधीच नसते. येथे एकच आहे, आणि इंटरफेस त्याचा इतरांप्रमाणेच क्लायंट आहे — हे आमच्यावरील निर्बंध आहे, आणि तुम्हाला काय बांधायचे आहे ते सर्व शक्य होण्याचे कारण आहे.

त्या नियमाची खरी किंमत काय

याचा अर्थ असा की स्क्रीनला कधी कधी API बरोबर होण्याची वाट पाहावी लागते, एका सोयीच्या फील्डसाठी त्याच्या आजूबाजूला जाण्याऐवजी. स्क्रीनला सार्वजनिक API देऊ शकत नाही असे काही हवे असल्यास तो दिवस API चुकीचा असतो, आणि उपाय API आहे.

फायदा असा की तीन अतिशय वेगळे क्लायंट जवळपास काहीही अतिरिक्त खर्च करत नाहीत. MCP सर्व्हर एक क्लायंट आहे. dash-b टाइल एक क्लायंट आहे. तुमचे स्वतःचे स्क्रिप्ट एक क्लायंट आहे. त्यापैकी कोणीही दुसऱ्या व्यक्तीसाठी डिझाइन केलेल्या पृष्ठभागाभोवती काम करणारा दुय्यम नागरिक नाही, कारण दुय्यम होण्यासाठी दुसरा पृष्ठभागच नाही.

प्रलंबित, आणि वापरलेले

OpenAPI /docs वर जनरेट केले जाते आणि प्रत्येक रूटची चाचणी दस्तऐवजातील उदाहरण आहे. कोडपासून वेगळे लिहिलेले दस्तऐवज एका महिन्यात बासनात जातात; चुकीचे असल्यास बिल्ड फेल करणारे दस्तऐवज जात नाहीत.

साइन इन करणे

तुमचे castomo खाते, PKCE सह ऑथरायझेशन कोड फ्लोवर — dash-b आणि कुटुंबातील बाकीसाठी वापरता तेच खाते. स्वतःचा सर्व्हर नसलेले पान तो फ्लो छान चालवू शकते; तोच फ्लो डिझाइन केला गेला होता. मशीन-टू-मशीन कामासाठी, प्रोजेक्ट-स्कोप्ड API की.

पृष्ठभागapi.clicksomo.com

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 वापरते तीच यंत्रणा आहे, फक्त त्यात वेगळे नाव असते.

आपला इव्हेंट फनल बनतोapi_event

1आपण तो पोस्ट करताPOST /v1/events — एक नाव, एक संपर्क, एक पेलोड, एक आयडेम्पोटेन्सी की.
2तो पोहोचतोसंपर्काच्या नोंदीत जोडला जातो. तो अस्तित्वात आहे हे दुसऱ्या कोणालाही जाणून घ्यावे लागत नाही.
3फनल सुरू होतेज्या फनलच्या प्रवेशात तो इव्हेंट नमूद आहे, अशा प्रत्येक फनलसाठी, त्याच्या प्रवेश निकषांनुसार पात्र असलेल्या प्रत्येक संपर्कासाठी.
4इतर फनल त्यावर फाटे फोडतात"हा इव्हेंट गेल्या १४ दिवसांत घडला आहे का" हा एक सामान्य विभाग निकष आहे.
iआणि तो धावणे संपवतोतोच इव्हेंट नमूद करणारा ध्येय नोड व्यक्तीने ते कृती केल्याक्षणी क्रम थांबवतो.

आपली शब्दावलीआपले टोकन

बांधणी सुरू करण्यापूर्वी जाणून घेण्यासारख्या मर्यादा

ClickSomo आपल्याबद्दल तीन ओळखकर्ते साठवते — टेनंट, प्रोजेक्ट आणि वापरकर्ता, अपारदर्शक आयडी म्हणून — आणि दुसरे काहीही नाही. पासवर्ड नाही, प्रोफाइल नाही, कार्ड नाही, बिल नाही. योजनेच्या मर्यादा संख्या म्हणून येतात: किती संपर्क, किती पाठवण्या, किती निर्मित्या. पेमेंट शब्दावली त्या रेषेच्या दोन्ही दिशांनी ओलांडत नाही.

आपले संपर्क आपलेच आहेत. आपण डेटा नियंत्रक आहात; आम्ही प्रोसेसर आहोत. कुटुंबातील दुसरे उत्पादन आपली संपर्क यादी वाचू किंवा लिहू शकेल असा कोणताही मार्ग नाही, आणि त्यासाठी कोणताही इनजेस्ट मार्ग नाही.

आपण याचे गांभीर्याने मूल्यांकन करत असल्यास: या संकेतस्थळाचे आणखी वाचन करण्यापूर्वी /docs वाचा. API हे उत्पादन काय करते याचे प्रामाणिक वर्णन आहे, आणि या पानांवरील प्रत्येक दावा तेथे सापडणाऱ्या मार्गाशी किंवा नोड प्रकाराशी जोडलेला आहे. स्कीमा बदलल्यावर ही पाने बदलतात.