API

የግል endpoint የለም። ለአይንቀጽም እንኳ የለም።

አብዛኛዎቹ ምርቶች ሁለት APIዎች አሏቸው፦ የሚሰጥዎት የተጻፈ ሰነድ ያለው እና ስክሪኖቻቸው የሚጠቀሙበት አስደሳች አንድ። ሁለተኛው ሁልጊዜ የተሻለ ነው፣ እርስዎም ፈጽሞ አትቀርቡበትም። እዚህ ግን አንድ ብቻ አለ፣ አይንቀጹም ልክ ማንኛውም ነገር እንደሚሆን የዚያ API ደንበኛ ነው — ይህ ለእኛ ገደብ ነው፣ እርስዎ መገንባት የሚፈልጉት ሁሉ ለምን እንደሚቻል ምክንያቱም ነው።

ይህ ሕግ በእውነቱ የሚያስከፍለው ዋጋ

ማለቱ አንድ ስክሪን አንድ ተመቻች መስክ ለመድረስ ዙሪያውን ከመውጣት ይልቅ አልፎ አልፎ API ትክክል መሆኑን መጠበቅ እንዳለበት ነው። አንድ ስክሪን የሕዝብ API ሊሰጠው የማይችል ነገር የሚያስፈልገው ቀን፣ API የተሳሳተ የሚሆነው ቀን ነው፣ እና መፍትሄውም API ነው።

የሚገኘው ጥቅም ሦስት በጣም የተለያዩ ደንበኞች ምንም ተጨማሪ ወጪ እንደሌላቸው ነው። MCP ሰርቨሩ ደንበኛ ነው። የdash-b ታይል ደንበኛ ነው። የርስዎ ስክሪፕት ደንበኛ ነው። ሁሉም ለሌላ ሰው የተነደፈ ገጽ ዙሪያ የሚሠራ ሁለተኛ ደረጃ ዜጋ አይደለም፣ ምክንያቱም ሁለተኛ የሚሆንበት ሌላ ገጽ የለም።

የተጻፈ ሰነድ ያለው፣ እና የተሞከረ

OpenAPI በ/docs ላይ ይመነጻል እንዲሁም እያንዳንዱ መንገድ በሰነዱ ውስጥ ምሳሌ የሆነ ፈተኔ አለው። ከኮዱ በተለየ የተጻፈ ሰነድ በአንድ ወር ውስጥ ይለወጣል፤ ስህተት ሲሆን ግንባታውን የሚያሳንፍ ሰነድ ግን አይለወጥም።

መግቢያ

የርስዎ castomo መለያ፣ በPKCE ያለው authorization code flow ላይ — 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/*

OpenAPI በ/docs/mcp በተመሳሳይ ፕሮሴስ ላይ

ልማዶች

ከሌሎች ሁሉ castomo አገልግሎቶች ጋር ተመሳሳይ ቅርጽ

ከሚሰማው የበለጠ ወሳኝ ነው። ከእነዚህ አንዱን ቀድሞ ከጠሩ፣ ይህ እንዴት እንደሚመልስ፣ እንደሚወድቅ እና እንደሚከፋፍል ቀድሞ ያውቃሉ።

አንድ የስህተት ኮፍያ

እያንዳንዱ ውድቀት ተመሳሳይ ቅርጽ አለው፣ የተረጋገጠ ኮድ እና ለሰው የታሰበ መልእክት። ምንም መንገድ የራሱ የሆነ የመቸኮል መንገድ አይፈጥርም።

የኮርሰር ገጽ ማዞር

ቅደም ተከተል አይደለም። እየተራመዱ ሳለ የሚለወጥ ዝርዝር ረድፎችን በጸጥታ አይዝለልም ወይም አይድገምም፣ ይህን የሚያደርገው ቅደም ተከተል ገጽ ማዞር በጸጥታ እና በየጊዜው ነው።

የIdempotency ቁልፎች

በእያንዳንዱ የሚቀይር መንገድ ላይ። ደርሷል የማታውቀውን ጥያቄ እንደገና ሞክረው ሁለተኛ ተግባር፣ ሁለተኛ ዘመቻ ወይም ሁለተኛ መላክ ከመሆን ይልቅ ተመሳሳይ መልስ ያገኛሉ።

በፕሮጀክት የተገደበ

አንድ ቶከን አንድ ተከራይ እና አንድ ፕሮጀክት፣ ሁለቱንም ይናገራል። የረድፍ ደረጃ ደህንነት በመረጃ ቋቱ ራሱ ውስጥ ይተገበራል፣ በተጨማሪ አንቀጽ መጨመርን በማስታወስ አይደለም።

የሚወጡ Webhooks

የተፈረሙ፣ በbackoff የሚደገሙ፣ እና ቢያንስ አንድ ጊዜ የሚደርሱ — ስለዚህ የርስዎ endpoint ምላሽ መድገም መቻል አለበት። ክስተቶቹ ሪፖርቶች የሚጠቀሙት ተመሳሳይ ቃላት ናቸው።

መሰረዝና ማውጣት

አንድ እውቂያ በAPI በኩል ሊወጣ ወይም ሊሰረዝ ይችላል፣ እና መሰረዝ በቤተሰቡ የውስጥ መስመር ቅጂ ያዘው እያንዳንዱ የእህት አገልግሎት ይደርሳል።

በይነገጹ ማድረግ የሚችለው ሁሉ፣ አንድ POST ማድረግ ይችላል።

ክስተቶች አስደሳቹ ክፍል ናቸው

በዚህ ገጽ ላይ ያለው ሌላ ሁሉ የሚጠበቅ ቧንቧ ነው። POST /v1/events የምርቱን ዓላማ የሚቀይረው መንገድ ነው።

መተግበሪያዎ ማንኛውም የገበያ መሳሪያ ሊያውቃቸው የማይችል ነገሮችን አስቀድሞ ያውቃል፦ ማን onboarding ያለቀው፣ ማን ባልደረባ የጋበዘው፣ ማን ገደብ የደረሰው፣ ማን በእሁድ ከሰዓት መረጃውን የወጣው። በራስዎ ቶከን እነሱን እንደ ክስተት ይላኩ፣ እያንዳንዱ ተግባር፣ ሁኔታና ክፍል ይሆናል።

ቀሪው ሁሉ ከእውቂያ ሞዴሉ ይከተላል። ክስተቶች ይጨምራሉ፣ አይስተካከሉም፤ ምርቱ ሙሉ በሙሉ የተንጠለጠለበት መዝገብ ናቸው። በእርስዎ በገለጹት ክስተት ላይ የሚነሳ ፈንነል ውህደት አይደለም — message_opened የሚጠቀመው ተመሳሳይ ዘዴ ነው፣ በውስጡ የተለየ ስም ብቻ ያለው።

የእርስዎ ክስተት ፈንነል ይሆናልapi_event

1እርስዎ ይላኩታልPOST /v1/events — ስም፣ እውቂያ፣ ጭኜ፣ የidempotency ቁልፍ።
2ይደርሳልወደ እውቂያው መዝገብ ይጨምራል። ሌላ ማንም መኖሩን ማወቅ አያስፈልገውም።
3ፈንነል ይጀምራልመግቢያው ያ ክስተትን የሚጠቅስ ማንኛውም ፈንነል፣ በመግቢያ መስፈርቱ ብቁ ለሆነ ማንኛውም እውቂያ።
4ሌሎች ፈንነሎች በላይቱ ይከፈላሉ"ይህ ክስተት ባለፉት 14 ቀናት ውስጥ ተከስቷል" የሚለው መጠበቂያ የተለመደ የክፍል ተንትን ነው።
iእና እነርሱን ያበቃልተመሳሳዩን ክስተት የሚጠቅስ የግብ አንጁ ሰውየው ነገሩን ሲያደርግ በዲቃ ተራራቁትን ያቆማል።

የእርስዎ ቃላትየእርስዎ ቶከን

ከመገንባትዎ በፊት ማወቅ የሚገባቸው ገደቦች

ClickSomo ስለእርስዎ ሦስት መለያዎችን ያስቀምጣል — ቴናንት፣ ፕሮጀክትና ተጠቃሚ፣ እንደ ግልጽ ያልሆኑ መለያዎች — ከዚያ በላይ ምንም አይደለም። የመግቢያ ቃል የለም፣ መገለጫ የለም፣ ካርድ የለም፣ ደረሰኝ የለም። የዕቅድ ገደቦች እንደ ቁጥሮች ይመጣሉ፦ ስንት እውቂያዎች፣ ስንት መላኮች፣ ስንት ማመንጨቶች። የክፍያ ቃላት ያ መስመር በሁለቱም አቅጣጫ አይሻገሩም።

የእርስዎ እውቂያዎች የእርስዎ ናቸው። እርስዎ የመረጃ ቁጥጥር አድራጊ ነዎት፤ እኛ አቀናባሪ ነን። በቤተሰቡ ውስጥ ሌላ ምርት የእርስዎን የእውቂያ ዝርዝር ማንበብ ወይም መጻፍ የሚችልበት መንገድ የለም፣ እንዲጠቀም የሚያስችል የመረጃ መግቢያ መስመርም የለም።

ይህን በትክክል እየገመገሙ ከሆነ፦ ይህን ድህረ ገጽ ከመቀጠልዎ በፊት /docs ያንብቡ። API ምርቱ ምን እንደሚያደርግ እውነተኛ መግለጫ ነው፣ እና በእነዚህ ገጾች ላይ ያለው እያንዳንዱ ቃል በዚያው ሊገኝ የሚችል መንገድ ወይም የአንጁ ዓይነት ጋር ይገጥማል። ስኪማው ሲቀየር፣ እነዚህ ገጾች ይቀየራሉ።