clickSomo
ClickSomo bani

API

Endpoint okkootu hin jiru. Interfeesitiifille miti.

Oomishaaleen baay'een API lama qabu: kan galmeeffame ati kennamu, fi kan screenota isaanii ofii fayyadamu. Kan lammaffaan yeroo hunda caalmaa dha, ati immoo gara isaa hin dhiyaattu. Asitti tokko qofa jira, interfeesisin akka fayyadamaa biraa isaa fayyadama — kun nuuf daangeessaa dha, fi sababa waan ati ijaaruu barbaaddu hunda danda'amu.

Seerichi dhugumaan maal kaffalaa?

Isaanis screen yeroo tokko tokko API'n sirrii ta'uuf eegachuu qaba jechuudha, dirree tokko salphaatti fudhachuuf isaa darbuu dhabuu. Guyyaa screen waan API'n uumamaan kennuu hin dandeenye barbaadu, guyyaa API'n dogoggoraa ta'e dha; furmaataanis API dha.

Fayyidni isaa fayyadamtoota adda addaa sadii kaffala dabalataa xiqqoo qofa fudhatu. MCP server fayyadamaa dha. Dash-b tile fayyadamaa dha. Scriptiin kee fayyadamaa dha. Iskeen kam iyyuu namni biraaaf qopheeffame darbee darbee hojjachuu qabu miti, sababa isaan lammaffaa ta'uun isaa hin jiru.

Galmeeffame, fi hojjetamaa

OpenAPI'n /docs irratti uumamaa dha, fi daangaa hunda qormaata galmee keessatti fakkeenyi ta'e qaba. Galmee koodii irraa addaatti barreeffame ji'a tokko keessatti addaan ba'a; galmee yeroo dogoggoraatti ijaaruu kufe hin qabu.

Seeni

Herrega castomo kee, authorization code flow with PKCE'n — herrega dash-b fi maatiin biraa hunda fayyadamtu sana. Server ofii hin qabne fuula tokko flow sana gaarii hojjeta; kan flow'n qopheeffameefis. Hojii machine-to-machine'f, API key project-scoped.

Bakkaapi.clicksomo.com
  • 1Namoota/v1/contacts · /lists · /segments · /tags · /imports
  • 2Qabiyyee/v1/creatives, mirkanaa, preview fi render target hundaaf
  • 3Awtomeeshinii/v1/funnels · /funnels/:id/versions · /runs · /simulate
  • 4Tamsaasa/v1/campaigns, audience, materialise, schedule fi send tarkaanfii adda addaa ta'anii
  • 5Taateewwan seenu/v1/events — taateewwan appikeeshinii kee, kaka'uudhaaf
  • 6Geessuu/sender-identities · /domains · /apps · /webhooks
  • 7Lakkoofsa/v1/reports/*, fi /track/* host seera qabamee irratti

OpenAPI /docs irratti/mcp piroosesii tokko irratti

Amala

Boca tajaajila castomo biraa hunda waliin tokko

Kun dhageenya caalmaa barbaachisaa dha. Yoo isaan tokko duraan waamte, akkasitti kun deebiu, kufe, fi fuula itti darbu beekta.

Envelope dogoggora tokko

Kufe hunda boca tokko, koodii tasgabbii qabu, fi ergaa namni fayyadameef qopheeffame qaba. Daangaan kam iyyuu akkasitti rakkisuu isaa ofii hin uumu.

Fuula itti darbu cursor

Offset miti. Tarreewwan ati darbu yeroo jijjiiramuu isaa hin darbuu fi hin irra deebi'u, kun offset pagination'n tasgabbisaan yeroo hunda ta'aa dha.

Iddoo idempotency

Daangaa jijjiiraa hunda irratti. Deebii hin beekne irra deebi'i, deebii tokko fudhadhu — namoonni lama, kampanii lama, ykn geessuu lama osoo hin taane.

Piroojektii dhaan daangeffame

Tookkiin tenant tokko fi piroojektii tokko, lamaanuu, ni qunnama. Row-level security database ofii keessatti mirkanaa dha, clause dabaluu yaadachaan osoo hin taane.

Webhooks ba'a

Mallatteffame, backoff'n irra deebi'ame, yeroo tokko ol geessame — endpoint kee idempotent ta'uu isaa qaba. Taateewwan gabaasota fayyadaman jecha tokko fayyadu.

Haqquu fi baasuu

Qunnamtichi API'n baafamee ykn haqqamuu danda'a, fi haqqiin tajaajila obboleeyyan kopii qaban hunda garaa garaa maatiin ofii keessatti gaheera.

Wanti interfeesiin danda'u hunda, POSTin danda'a.

Taqabiyyoon wanta sochii qabu

Wantoota fuula kana irratti hafan hundi sochiin isin beektan. POST /v1/events daandii ogeessa kanaaf maal ta'u jijjiiruudha.

Applikeeshiniin kee wanta meeshaa marketing tokkoon ilaaluu hin dandeenye beera: namni onboarding xumure, namni obboleessa waamte, namni daangaa tuqe, namni dataa isaa Wiibata galgala baay'ise. Isaan taqabiyyoo taasisii, mallattoo kee ofii waliin ergaa, tokkoon tokkoon isaanii ta'uun isaa kakaasa, haala fi gosa ta'a.

Kan hafe moodeela qunnameen irraa hordofa. Taqabiyyoon dabalama, guyyuu hin gargarqabu; logii ogeessi guutun isaan irratti hidhame. Fanaasni taqabiyyoo ati ibse irratti kaka'u integreeshinii miti — madaalama message_opened fayyadame, maqaa adda qabu qofa.

Taqabiyyoon kee fanaasa ta'aapi_event
  • 1Ati ergituPOST /v1/events — maqaa, qunname, paayiloodii, furmaata idempotency.
  • 2Itti gahuLogii qunnameen irratti dabalama. Wanti biraa jiraachisa isaa beekuu hin barbaadu.
  • 3Fanaasni jalqabaFanaasa kamiyyuu seensa isaa taqabiyyoo sana ibsu, qunname kamiyyuu seensa isaa jalatti akkaataa ta'e.
  • 4Fanaasota biroo isaan irratti gargar ba'u"Taqabiyyoon kun guyyoota 14 darbe keessatti ta'eraa?" ibsa gosa idilee dha.
  • iAkkaataa isaa xumuraIddoo goolii taqabiyyoo tokko ibsu kan wal fakkaatu tartiiba dhaabbisa yeroo namni sun wanta sana raawwatu.

Jechoota keeMallattoo kee

Daangaa beekuu qabdu ogeessa kee dura

ClickSomo addattoota sadii waa'ee kee kuusa — tenant, pirojektii fi fayyadamaa, ids dhokataa ta'an — kan biraa hin qabu. Jecha icciitii, piroofaayilii, kaardii, invooysii hin qabu. Daangaa pilaan lakkoofsota ta'aniitti dhufu: qunnamtoota meeqa, ergaasota meeqa, uumamsota meeqa. Jechoota kaffalaa daangaa sana cinaa hin darbu, gara tokkoon iyyuu.

Qunnamtoonni kee kan kee ti. Ati too'ataa daataa ti; nu tajaajilaa dha. Daandii ogeessi biraa maataa kana keessaa jiru tarreewwan qunnamtoota kee dubbisuu ykn barreessuu hin danda'u, fi daandii ingistii tokkoon fayyadamuuf hin jiru.

Yoo ati kun cimaa ilaalaa jirta ta'e: fuula websaayitii kana dabalataan dubbisuu dura /docs dubbisi. API ibsa dhugaa wanti ogeessi raawwatu ti, fi ibsi hundinuu fuulota kana irratti daandii ykn gosa iddoo achitti argamuu danda'u waliin wal qaba. Yoo skeemaa jijjiiramule, fuulonni kunis ni jijjiiramu.