API එක
පුද්ගලික endpoint එකක් නොමැත. අතුරුමුහුණතට පවා නැත.
බොහෝ නිෂ්පාදනවල API දෙකක් ඇත: ඔබට පිරිනමන ලේඛනගත කළ එක, සහ ඔවුන්ගේම තිර භාවිත කරන රසවත් එක. දෙවන එක සැමවිටම වඩා හොඳ වන අතර ඔබට එය අසලට පැමිණීමට කිසිදා අවසර නැත. මෙහි එකක් පමණක් ඇති අතර අතුරුමුහුණත එහි අනෙක් ඕනෑම දෙයක් මෙන් එහි සේවාදායකයෙකි — එය අපට පනතක් වන අතර, ඔබ ගොඩනැගීමට කැමති සියල්ල සිදු කළ හැකි වන්නේ එහි හේතුවෙනි.
එම නියමය ඇත්ත වශයෙන් ගෙවන මිල
එනම් තිරයකට සුවිශේෂී ක්ෂේත්‍රයක් සඳහා එය වටා ගොස් නොව, API එක නිවැරදි වන තුරු සමහර විට රැඳී සිටිය යුතුය. තිරයකට පොදු API එකට ලබා දිය නොහැකි දෙයක් අවශ්‍ය වන දිනය API එක වැරදි දිනයයි, නිවැරදි කිරීම API එකයි.
එහි ප්‍රතිලාභය වන්නේ ඉතා වෙනස් සේවාදායක තුනකට අමතර පිරිවැය දැනටමත් නොමැති තරමට අඩු වීමයි. MCP සර්වරය සේවාදායකයෙකි. dash-b ටයිල් එකක් සේවාදායකයෙකි. ඔබේම ස්ක්‍රිප්ට් එක සේවාදායකයෙකි. ඒ කිසිවක් අනෙක් අයට වඩා අඩු පුරවැසියෙකු නොවේ, මන්ද දෙවන ස්ථානයක් නොමැති නිසාය.
ලේඛනගත කර, භාවිත කර ඇත
OpenAPI එක /docs හි ජනනය කරන අතර සෑම මාර්ගයකටම ලේඛනවල උදාහරණය වන පරීක්ෂණයක් ඇත. කේතයෙන් වෙන්ව ලියන ලද ලේඛන මාසයක් ඇතුළත වෙනස් වේ; වැරදි වූ විට ගොඩනැගීම අසාර්ථක වන ලේඛන එසේ නොවේ.
පිවිසීම
PKCE සහිත authorization code flow එක හරහා ඔබේ castomo ගිණුම — dash-b සහ පවුලේ අනෙක් ඒවා සඳහා ඔබ භාවිත කරන එම ගිණුමමය. තමන්ගේම සර්වරයක් නොමැති පිටුවක් එම flow එක හොඳින් ක්‍රියාත්මක කරයි; එය එම flow එක සැලසුම් කරන ලද අරමුණයි. යන්ත්‍රයෙන් යන්ත්‍රයට වැඩ සඳහා, ව්‍යාපෘතියට බැඳුණු 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 සේවයක මෙන්ම එකම හැඩය
එය ඇසෙන පමණට වඩා වැදගත් වේ. ඔබ දැනටමත් මේවායින් එකකට කැඳවන්නේ නම්, මෙය පිළිතුරු දෙන, අසාර්ථක වන සහ පිටු සංඛ්‍යාකරණය කරන ආකාරය ඔබ දැනටමත් දනී.
එක් දෝෂ ආවරණයක්
සෑම අසාර්ථකයකටම එකම හැඩය, ස්ථාවර කේතයක් සහ මිනිසෙකු සඳහා අදහස් කළ පණිවිඩයක් ඇත. කිසිදු මාර්ගයක් අසතුටු වීමේ තමන්ගේම ක්‍රමයක් නිර්මාණය නොකරයි.
කර්සර පිටු සංඛ්‍යාකරණය
Offsets නොවේ. ඔබ එය ගමන් කරන අතරතුර වෙනස් වන ලැයිස්තුවක් පේළි නිශ්ශබ්දව මඟහරින්නේ හෝ නැවත නොපෙන්වයි — offset පිටු සංඛ්‍යාකරණය නිශ්ශබ්දව සහ නිතර කරන දෙයයි.
Idempotency යතුරු
වෙනස් කරන සෑම මාර්ගයකම. ලැබුණා දැයි ඔබට විශ්වාස නැති ඉල්ලීමක් නැවත උත්සාහ කරන්න, දෙවන සම්බන්ධතාවක්, දෙවන කාම්පේනයක් හෝ දෙවන යැවීමක් නොව එකම පිළිතුර ලැබේ.
ව්‍යාපෘතියකට සීමා කර ඇත
ටෝකනයක් එක් කුලකයක් සහ එක් ව්‍යාපෘතියක්, දෙකම අමතයි. පේළි මට්ටමේ ආරක්ෂාව දත්ත සමුදාය තුළම ක්‍රියාත්මක වන අතර, වගන්තියක් එකතු කිරීම මතක තබා ගැනීමෙන් නොවේ.
පිටතට වෙබ්හූක්
අත්සන් කර, backoff සමඟ නැවත උත්සාහ කර, අවම වශයෙන් එක් වරක්වත් බෙදා හරිනු ලැබේ — එබැවින් ඔබේ endpoint එකද idempotent විය යුතුය. සිදුවීම් වාර්තා භාවිත කරන එම ශබ්ද මාලාවමය.
මැකීම සහ නිර්යාදනය
සම්බන්ධතාවයක් API හරහා නිර්යාදනය කළ හැකි හෝ මකා දැමිය හැකි අතර, මැකීමක් පවුලේ අභ්‍යන්තර මාර්ගය හරහා පිටපතක් තබා ගත් සහෝදර සේවා සෑම එකකටම ළඟා වේ.
අතුරුමුහුණට කළ හැකි සෑම දෙයක්ම POST එකකට කළ හැකිය.
සිදුවීම් වනාහි රසවත් කොටසයි
මෙම පිටුවේ ඇති අනෙක් සියල්ල ඔබ අපේක්ෂා කරන පදනම් යටිතලයයි. POST /v1/events යනු නිෂ්පාදනයේ අරමුණ වෙනස් කරන මාර්ගයයි.
ඔබේ යෙදුම දන්නා, කිසිදු අලෙවි මෙවලමකට නිරීක්ෂණය කළ නොහැකි කරුණු ඇත: ආරම්භක පියවර අවසන් කළ තැනැත්තා, සෙසු සේවකයෙකු ආරාධනා කළ තැනැත්තා, සීමාවකට ලක් වූ තැනැත්තා, ඉරිදා දහවලක තම දත්ත නිර්යාදනය කළ තැනැත්තා. ඔබේම ටෝකනය සමඟ ඒවා සිදුවීම් ලෙස පළ කරන්න, එවිට එක් එක් එක ට්‍රිගරයක්, කොන්දේසියක් සහ කණ්ඩායමක් බවට පත් වේ.
ඉතිරි සියල්ල සම්බන්ධතා ආකෘතියෙන් අනුගමනය වේ. සිදුවීම් එකතු කරනු ලබන අතර කිසිදා සංස්කරණය නොකෙරේ; ඒවා සමස්ත නිෂ්පාදනය රඳා පවතින සිදුවීම් සටහනයි. ඔබ නිර්වචනය කළ සිදුවීමක් මත ක්‍රියාත්මක වන ෆනල් එකක් ඒකාබද්ධයක් නොවේ — එය message_opened භාවිත කරන එම යාන්ත්‍රණයම වන අතර, එහි වෙනස් නමක් පමණි.
- 1ඔබ එය පළ කරයි
POST /v1/events— නමක්, සම්බන්ධතාවයක්, පේලෝඩ් එකක්, idempotency යතුරක්. - 2එය ලැගුම් ගනීසම්බන්ධතාවයේ සටහනට එකතු වේ. එය පවතින බව දැනගත යුතු වෙනත් කිසිවක් නැත.
- 3ෆනල් එකක් ආරම්භ වේඑහි ඇතුළුවීමේ නිර්ණායකය යටතේ සුදුසුකම් ලත් ඕනෑම සම්බන්ධතාවයක් සඳහා, ඇතුළුවීමේ නම එම සිදුවීම වන ඕනෑම ෆනල් එකක්.
- 4වෙනත් ෆනල් එය මත ශාඛා වේ"මෙම සිදුවීම පසුගිය දින 14 තුළ සිදු වී ද" යන්න සාමාන්‍ය කණ්ඩායම් ප්‍රධානියකි.
- iඑය ධාවන අවසන් කරයිඑම සිදුවීම නම් කරන ඉලක්ක නෝඩයක්, පුද්ගලයා එය සිදු කරන මොහොතේම අනුපිළිවෙලක් නවත්වයි.
ඔබේ ශබ්දකෝෂයඔබේ ටෝකනය
ගොඩනැගීමට පෙර දැනගත යුතු සීමාවන්
ClickSomo ඔබ ගැන අනන්‍ය අනන්‍යතා තුනක් සුරකියි — ටෙනන්ට් එකක්, ව්‍යාපෘතියක් සහ පරිශීලකයෙක්, අව්‍යක්ත අනන්‍යතා ලෙස — වෙනත් කිසිවක් නොවේ. මුරපදයක් නැත, පැතිකඩක් නැත, කාඩ්පතක් නැත, ඉන්වොයිසියක් නැත. සැලසුම් සීමාවන් සංඛ්‍යා ලෙස පැමිණේ: සම්බන්ධතා කීයක්ද, යැවීම් කීයක්ද, ජනනය කීයක්ද. ගෙවීම් පාරිභාෂිතය එම සීමාව දෙපැත්තෙන්ම තරණය නොකරයි.
ඔබේ සම්බන්ධතා ඔබේ ඒවාය. ඔබ දත්ත පාලකයා වන අතර අපි සැකසුම්කරු වෙමු. පවුලේ වෙනත් නිෂ්පාදනයකට ඔබේ සම්බන්ධතා ලැයිස්තුව කියවීමට හෝ ලිවීමට හැකි මාර්ගයක් නොමැති අතර, එකක් භාවිත කළ හැකි ඇතුළත් කිරීමේ මාර්ගයක් ද නැත.
ඔබ මෙය බරපතල ලෙස ඇගයෙමින් සිටින්නේ නම්: මෙම වෙබ් අඩවියේ තවත් කියවීමට පෙර /docs කියවන්න. API යනු නිෂ්පාදනය කරන දේ පිළිබඳ අවංක විස්තරයයි, මෙම පිටුවල ඇති සෑම සාක්ෂියක්ම එහි ඔබට සොයාගත හැකි මාර්ගයකට හෝ නෝඩ් වර්ගයකට අනුරූප වේ. ස්කීමාව වෙනස් වන විට, මෙම පිටු ද වෙනස් වේ.