API

தனிப்பட்ட எண்ட்பாயிண்ட் இல்லை. இடைமுகத்திற்குக் கூட இல்லை.

பெரும்பாலான தயாரிப்புகளில் இரண்டு API-கள் உள்ளன: உங்களுக்கு வழங்கப்படும் ஆவணப்படுத்தப்பட்ட ஒன்று, மற்றும் அவர்களின் சொந்த திரைகள் பயன்படுத்தும் சுவாரஸ்யமான ஒன்று. இரண்டாவது எப்போதும் சிறந்தது, மேலும் அதற்கு அருகில் நீங்கள் ஒருபோதும் அனுமதிக்கப்பட மாட்டீர்கள். இங்கே ஒன்றே உள்ளது, மேலும் இடைமுகம் வேறு எதுவும் போலவே அதன் ஒரு கிளையண்ட் — இது எங்கள் மீதான ஒரு கட்டுப்பாடு, மேலும் நீங்கள் உருவாக்க விரும்பும் அனைத்தும் சாத்தியமாகும் காரணம் இதுவே.

அந்த விதியின் உண்மையான விலை

இதன் பொருள், ஒரு திரை சில நேரங்களில் ஒரு வசதியான புலத்திற்காக API-ஐச் சுற்றி வளையாமல், API சரியாக இருக்கும் வரை காத்திருக்க வேண்டும். ஒரு திரைக்கு பொது API வழங்க முடியாத ஒன்று தேவைப்படும் நாள், API தவறாக இருக்கும் நாள், மேலும் தீர்வு API-ஐயே சரிசெய்வதாகும்.

இதன் பலன், மூன்று மிக வேறுபட்ட கிளையண்டுகளுக்கு கூடுதல் செலவு கிட்டத்தட்ட இல்லை என்பது. MCP சர்வர் ஒரு கிளையண்ட். ஒரு dash-b டைல் ஒரு கிளையண்ட். உங்கள் சொந்த ஸ்கிரிப்ட் ஒரு கிளையண்ட். அவற்றில் எதுவும் வேறு யாருக்காக வடிவமைக்கப்பட்ட மேற்பரப்பைச் சுற்றி வளையும் இரண்டாம் நிலை குடிமகன் அல்ல, ஏனெனில் இரண்டாம் நிலையில் இருக்க வேறு எந்த மேற்பரப்பும் இல்லை.

ஆவணப்படுத்தப்பட்டது, மேலும் பயன்படுத்தப்படுவதும்

OpenAPI /docs இல் உருவாக்கப்படுகிறது, மேலும் ஒவ்வொரு வழிக்கும் ஆவணத்தில் உள்ள எடுத்துக்காட்டாகவே இருக்கும் ஒரு சோதனை உள்ளது. குறியீட்டிலிருந்து தனித்து எழுதப்படும் ஆவணம் ஒரு மாதத்திற்குள் விலகிவிடும்; தவறாக இருக்கும்போது பில்டை தோல்வியுறச் செய்யும் ஆவணம் அப்படி இல்லை.

உள்நுழைவு

PKCE உடன் authorization code flow மூலம் உங்கள் castomo கணக்கு — dash-b மற்றும் குடும்பத்தின் மற்ற பயன்பாடுகளுக்கு நீங்கள் பயன்படுத்தும் அதே கணக்கு. சொந்த சர்வர் இல்லாத ஒரு பக்கம் அந்த flow-ஐ நன்றாக இயக்கும்; அதுவே அந்த flow வடிவமைக்கப்பட்ட நோக்கம். இயந்திரத்திலிருந்து இயந்திரத்திற்கான பணிகளுக்கு, திட்டத்திற்கு வரம்புடைய ஒரு 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மற்ற ஃபனல்கள் அதன் மீது கிளைக்கின்றன"இந்த நிகழ்வு கடந்த 14 நாட்களில் நிகழ்ந்ததா" என்பது ஒரு சாதாரண பிரிவு நிபந்தனை.
iமேலும் அது இயக்கங்களை முடிவுக்குக் கொண்டுவருகிறதுஅதே நிகழ்வைக் குறிப்பிடும் ஒரு இலக்கு முனை, நபர் அந்தச் செயலைச் செய்த தருணத்தில் ஒரு வரிசையை நிறுத்துகிறது.

உங்கள் சொல்லகம்உங்கள் டோக்கன்

நீங்கள் கட்டமைப்பதற்கு முன் அறிந்து கொள்ள வேண்டிய எல்லைகள்

ClickSomo உங்களைப் பற்றி மூன்று அடையாளங்களை சேமிக்கிறது — ஒரு குத்தகைதாரர், ஒரு திட்டம் மற்றும் ஒரு பயனர், வெளிப்படையற்ற ஐடிகளாக — வேறு எதுவும் இல்லை. கடவுச்சொல் இல்லை, சுயவிவரம் இல்லை, அட்டை இல்லை, விலைப்பட்டியல் இல்லை. திட்ட வரம்புகள் எண்களாக வருகின்றன: எத்தனை தொடர்புகள், எத்தனை அனுப்புதல்கள், எத்தனை உருவாக்கங்கள். கட்டண சொல்லகம் அந்த எல்லையை எந்த திசையிலும் கடக்காது.

உங்கள் தொடர்புகள் உங்களுடையவை. நீங்கள் தரவுக் கட்டுப்பாட்டாளர்; நாங்கள் செயலாக்குநர். குடும்பத்தில் உள்ள மற்றொரு தயாரிப்பால் உங்கள் தொடர்புப் பட்டியலைப் படிக்கவோ எழுதவோ முடியும் என்ற வழி இல்லை, மேலும் ஒன்று பயன்படுத்த எந்த உட்கொள்ளல் வழியும் இல்லை.

இதை தீவிரமாக மதிப்பிடுகிறீர்கள் என்றால்: இந்த இணையதளத்தை மேலும் படிப்பதற்கு முன் /docs ஐப் படியுங்கள். API என்பது தயாரிப்பு என்ன செய்கிறது என்பதன் நேர்மையான விளக்கம், மேலும் இந்தப் பக்கங்களில் உள்ள ஒவ்வொரு கூற்றும் அங்கு நீங்கள் காணக்கூடிய ஒரு வழித்தடம் அல்லது முனை வகையுடன் தொடர்புடையது. ஸ்கீமா மாறும்போது, இந்தப் பக்கங்களும் மாறும்.