clickSomo
ClickSomo തുറക്കുക

API

സ്വകാര്യ എൻഡ്പോയിന്റ് ഇല്ല. ഇന്റർഫേസിന് പോലുമില്ല.

മിക്ക ഉൽപ്പന്നങ്ങൾക്കും രണ്ട് API-കളുണ്ട്: നിങ്ങൾക്ക് നൽകുന്ന ഡോക്യുമെന്റ് ചെയ്തത്, അവരുടെ സ്വന്തം സ്ക്രീനുകൾ ഉപയോഗിക്കുന്ന രസകരമായത്. രണ്ടാമത്തേത് എപ്പോഴും മികച്ചതാണ്, നിങ്ങൾക്ക് അതിനടുത്തേക്ക് ഒരിക്കലും അനുവദിക്കുന്നില്ല. ഇവിടെ ഒന്നേ ഉള്ളൂ, ഇന്റർഫേസ് മറ്റെല്ലാറ്റിന്റെയും പോലെ അതിന്റെ ഒരു ക്ലയന്റാണ് — അത് ഞങ്ങൾക്ക് ഒരു നിയന്ത്രണമാണ്, നിങ്ങൾ നിർമ്മിക്കാൻ ആഗ്രഹിക്കുന്ന എല്ലാം സാധ്യമാക്കുന്നത് അതാണ്.

ആ നിയമം യഥാർത്ഥത്തിൽ ചെലവാക്കുന്നത് എന്താണ്

അതിന്റെ അർത്ഥം ഒരു സ്ക്രീൻ ചിലപ്പോൾ API ശരിയാകുന്നതിനായി കാത്തിരിക്കണം, ഒരു സൗകര്യപ്രദമായ ഫീൽഡിനായി അതിനെ മറികടക്കാൻ പാടില്ല. ഒരു സ്ക്രീനിന് പൊതു API-ന് നൽകാൻ കഴിയാത്ത എന്തെങ്കിലും ആവശ്യമുള്ള ദിവസം തന്നെയാണ് API തെറ്റായ ദിവസം, പരിഹാരം API തന്നെയാണ്.

പ്രതിഫലം എന്നത് മൂന്ന് വളരെ വ്യത്യസ്തമായ ക്ലയന്റുകൾക്ക് കാര്യമായ അധിക ചെലവ് ഒന്നുമില്ല എന്നതാണ്. MCP സെർവർ ഒരു ക്ലയന്റാണ്. ഒരു dash-b ടൈൽ ഒരു ക്ലയന്റാണ്. നിങ്ങളുടെ സ്വന്തം സ്ക്രിപ്റ്റ് ഒരു ക്ലയന്റാണ്. അവയിൽ ഒന്നും മറ്റൊരാൾക്കായി രൂപകൽപ്പന ചെയ്ത ഒരു ഉപരിതലത്തെ മറികടക്കുന്ന രണ്ടാം തരം പൗരന്മാരല്ല, കാരണം രണ്ടാമതിരിക്കാൻ മറ്റൊരു ഉപരിതലമില്ല.

ഡോക്യുമെന്റ് ചെയ്തതും പരിശോധിക്കപ്പെട്ടതും

OpenAPI /docs-ൽ ജനറേറ്റ് ചെയ്യപ്പെടുന്നു, എല്ലാ റൂട്ടിനും ഡോക്യുമെന്റേഷനിലെ ഉദാഹരണമായ ഒരു ടെസ്റ്റ് ഉണ്ട്. കോഡിൽ നിന്ന് വേറിട്ട് എഴുതുന്ന ഡോക്യുമെന്റേഷൻ ഒരു മാസത്തിനുള്ളിൽ വ്യതിചലിക്കുന്നു; തെറ്റായാൽ ബിൽഡ് പരാജയപ്പെടുന്ന ഡോക്യുമെന്റേഷൻ അങ്ങനെ ചെയ്യുന്നില്ല.

സൈൻ ഇൻ ചെയ്യൽ

PKCE ഉള്ള authorization code flow-ലൂടെ നിങ്ങളുടെ castomo അക്കൗണ്ട് — 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മറ്റ് ഫണലുകൾ അതിൽ ശാഖകളാകുന്നു"ഈ ഇവന്റ് കഴിഞ്ഞ 14 ദിവസത്തിനുള്ളിൽ സംഭവിച്ചിട്ടുണ്ടോ" എന്നത് ഒരു സാധാരണ സെഗ്മെന്റ് പ്രഡിക്കേറ്റ് ആണ്.
  • iകൂടാതെ അത് റണ്ണുകൾ അവസാനിപ്പിക്കുന്നുഅതേ ഇവന്റിന്റെ പേര് പറയുന്ന ഒരു ഗോൾ നോഡ്, വ്യക്തി ആ കാര്യം ചെയ്യുന്ന നിമിഷം ഒരു സീക്വൻസ് നിർത്തുന്നു.

നിങ്ങളുടെ പദാവലിനിങ്ങളുടെ ടോക്കൺ

നിർമ്മാണം തുടങ്ങും മുമ്പ് അറിയേണ്ട പരിധികൾ

നിങ്ങളെക്കുറിച്ച് ClickSomo മൂന്ന് ഐഡന്റിഫയറുകൾ സൂക്ഷിക്കുന്നു — ഒരു ടെനന്റ്, ഒരു പ്രോജക്റ്റ്, ഒരു ഉപയോക്താവ്, അപാരദർശി ഐഡികളായി — അത്രമാത്രം. പാസ്വേഡില്ല, പ്രൊഫൈലില്ല, കാർഡില്ല, ഇൻവോയ്സില്ല. പ്ലാൻ പരിധികൾ സംഖ്യകളായി എത്തുന്നു: എത്ര കോൺടാക്റ്റുകൾ, എത്ര അയക്കലുകൾ, എത്ര ജനറേഷനുകൾ. പേയ്മെന്റ് പദാവലി ആ രേഖയെ ഒരു ദിശയിലും കടക്കുന്നില്ല.

നിങ്ങളുടെ കോൺടാക്റ്റുകൾ നിങ്ങളുടേതാണ്. നിങ്ങളാണ് ഡാറ്റ കൺട്രോളർ; ഞങ്ങൾ പ്രോസസറാണ്. കുടുംബത്തിലെ മറ്റൊരു ഉൽപ്പന്നത്തിന് നിങ്ങളുടെ കോൺടാക്റ്റ് ലിസ്റ്റ് വായിക്കാനോ എഴുതാനോ കഴിയുന്ന ഒരു വഴിയുമില്ല, അത് ഉപയോഗിക്കാൻ ഒരു ഇൻജസ്റ്റ് ചാനലുമില്ല.

ഇത് ഗൗരവമായി വിലയിരുത്തുകയാണെങ്കിൽ: ഈ വെബ്സൈറ്റിന്റെ ഇനിയുള്ള ഭാഗം വായിക്കും മുമ്പ് /docs വായിക്കുക. API ആണ് ഉൽപ്പന്നം ചെയ്യുന്നതിന്റെ സത്യസന്ധമായ വിവരണം, ഈ പേജുകളിലെ ഓരോ അവകാശവാദവും അവിടെ കണ്ടെത്താവുന്ന ഒരു റൂട്ടിലേക്കോ നോഡ് തരത്തിലേക്കോ ബന്ധപ്പെട്ടിരിക്കുന്നു. സ്കീമ മാറുമ്പോൾ, ഈ പേജുകളും മാറുന്നു.