I-API

Ayikho i-endpoint eyimfihlo. Nokho ngisho nesixhumi esibonakalayo.

Imikhiqizo eminingi inama-API amabili: owocwaningo owunikezwa wona, nowayiziqhenyayo izikrini zayo ezisebenzisa wona. Owesibili uhlula njalo, futhi awuvunyelwe ukufinyelela kuye. Lapha kukunye kuphela, futhi isixhumi esibonakalayo singumklayenti walo njengento yonke enye — okuyisibopho kithina, futhi yisizathu sokuba konke osifuna ukwakha kuyenzeka.

Yini lo mthetho othile othinta ngayo

Kusho ukuthi isikrini ngezinye izikhathi kufanele silinde i-API ukuthi ilunge, esikhundleni sokudlula kuyo ukuze ithole insimu eyodwa elula. Usuku isikrini esidinga into i-API yomphakathi engayinikezi yilangaba i-API engalungile, futhi isixazululo yilona i-API.

Inzuzo wukuthi amaklayenti amathathu ahlukene kakhulu akhokhiswa cishe lutho ngaphezu kwalokho. Iseva ye-MCP iyiklayenti. Ithayili ye-dash-b iyiklayenti. Iskripthi sakho iyiklayenti. Akukho nalinye kubo lingumhloli wesibili osebenza ngendlela eyenzelwe omunye umuntu, ngoba ayikho enye indawo okumele ibe yeyesibili kuyo.

Ocwaningiwe, futhi osetshenzisiwe

I-OpenAPI ikhiqizwa ku-/docs futhi yonke indlela inohlolo oluyisibonelo ocwaningweni. Ucwaningo olubhalwa ehlukile kukhodi luyashintsha ngenyanga; ucwaningo olwehlulekisa ukwakha uma lungalungile alushintshi.

Ukungena ngemvume

I-akhawunti yakho ye-castomo, nge-authorization code flow ne-PKCE — i-akhawunti efanayo oyisebenzisela i-dash-b nomndeni wonke. Ikhasi elingenayo iseva yalo lingasebenzisa le flow kahle kahle; yilokho le flow eyenzelwe kona. Emsebenzini we-machine-to-machine, ukhiye we-API owodwa wephrojekthi.

Indawoapi.clicksomo.com

1Abantu/v1/contacts · /lists · /segments · /tags · /imports
2Okuqukethwe/v1/creatives, nokuqinisekiswa, ukubuka kusengaphambili nokunikezwa ngokwehlosiwe
3Ukuzenzakalela/v1/funnels · /funnels/:id/versions · /runs · /simulate
4Ukusakaza/v1/campaigns, nomphakathi, ukwenza ngokomzimba, ukucwangcisa nokuthumela njengezinyathelo ezihlukene
5Amacala angena/v1/events — amacala ohlelo lwakho lokusebenza, njengezibambelelo
6Ukulethwa/sender-identities · /domains · /apps · /webhooks
7Amanani/v1/reports/*, kanye ne-/track/* kumsingathi wokulandelela

I-OpenAPI ku-/docs/mcp kwenye iphroseyisi efanayo

Imigomo

Isakhiwo esifana nesevisi yonke ye-castomo enye

Okubalulekile kakhulu kunokuzwakala. Uma ususebenzisa enye yalezi, usuyazi ukuthi le uyiphendula kanjani, iyehluleka kanjani futhi ihlephulela kanjani.

Iphakheji yephutha elilodwa

Konke ukwehluleka kunesakhiwo esifana, ikhodi ezinzile nomlayezo owenzelwe umuntu. Ayikho indlela eqhamuka nendlela yayo yokungajabuli.

Ukuhlephulela nge-cursor

Hhayi ama-offset. Uhlu olushintshayo ngesikhathi usuhamba aludluleli noma aphinde amagama ngendlela efihlekile, okuyinto ama-offset ayenzayo njalo ngaphandle kokubonakala.

Okhiye bokungaphindwa

Kuzo zonke izindlela ezishintshayo. Phinda isicelo ongaqinisekile ukuthi safika uthole impendulo efanayo esikhundleni sokuthola oxhumana naye wesibili, uhlelo lwesibili noma ukuthumela kwesibili.

Kumiswe ngephrojekthi

Ithokheni ibheka isigcawu esisodwa nephrojekthi eyodwa, zombili. Ukuhlolwa kwezinga lomugqa kugcinwa kusizindalwazi ngokwaso, hhayi ngokukhumbula ukwengeza isigaba.

Ama-webhooks aphuma

Kusayinwe, kuphindwa nge-backoff, futhi kulethwe okungenani kanye — ngakho i-endpoint yakho kufanele ibe nokungaphindi nawe. Amacala ayigama elifanayo imibiko iyasebenzisa.

Ukucisha kanye nokuthunyelwa okuphumayo

Oxhumana naye ungathunyelwa ngaphandle noma acishwe nge-API, futhi ukucishwa kufika kuzo zonke izinsizakalo ezisibhangqa ezazigcina ikhophi ngesikhala sangaphakhi somndeni ngokwaso.

Konke okwenzayo inhlanganisela yomsebenzisi, i-POST ingakwenza.

Izehlakalo yingxenye enomqondo

Konke okunye kuleli kungumgqa wokuxhumana owulindelile. POST /v1/events yindlela eguqula inhloso yomkhiqizo.

Isicelo sakho sesivele sazi izinto ezingeke zibonwe ithuluzi lokumakethi: ngubani oqede ukungena, ngubani omemezele umsebenzi, ngubani ofikelele emkhawulweni, ngubani okhiphe imininingwane yakhe ngesonto ezingekusasa. Yithumela lezo zehlakalo ngetokho yakho, futhi ngasinye kuzoba isibani esiqalayo, isimiso kanye nesigaba.

Okunye kulandela imodeli yoxhumano. Izehlakalo ziyengezwa, azihlelwa; ziyilogi yonke into yomkhiqizo eyamamukela. I-funnel esebenza ngesehlakalo osichazile ayihlanganisi — kuyindlela efanayo message_opened esebenza ngayo, ngegama elahlukile kuyo.

Isehlakalo sakho siba i-funnelapi_event

1WuyithumelaPOST /v1/events — igama, oxhumana naye, imininingwane, ukhiye wokungaphindi.
2KufikaKuyengezwa kulogi yoxhumano. Akukho okunye okudinga ukwazi ukuthi likhona.
3I-funnel iqalaNoma yimuphi i-funnel enokungena okubiza leso sehlakalo, kwanoma yimuphi oxhumana naye ofanele ngokwekhasi yayo yokungena.
4Ezinye ii-funnel ziyahlukanisa ngakho"Ingabe le sehlakalo senzeke ezinsukwini ezingama-14 ezedlule" yisimiso esivamile sesigaba.
iFuthi kumisa ukusebenzaI-node yenjongo ebiza leso sehlakalo iyamisa uchungechugechunge ngaleso sikhathi umuntu enza into.

Isichazamazwi sakhoIthokho yakho

Imingcele efanele uyazi ngaphambi kokwakha

I-ClickSomo igcina izimpawu ezintathu ngawe — i-tenant, iphrojekthi nomsebenzisi, njengezimpawu ezingacacile — futhi akukho okunye. Ayikho iphasiwedi, ayikho iphrofayela, ayikho khadi, ayikho inkhokho. Imikhawulo yohlelo ifika njengezinombolo: mangaki oxhumana naye, mangaki okuthunyelwe, mangaki okukhiqiziwe. Amagama okukhokha awadluli leso sikhala noma ngakuphi.

Oxhumana nawe ungowakho. Ungumlawuli wemininingwane; thina singabasebenzisi bayo. Ayikho indlela umkhiqizo onye womndeni angafunda noma abhale ngayo uhlu lwakho loxhumano, futhi ayikho indlela yokufaka engayisebenzisa.

Uma uhlolisisa lokhu ngendlela esemqoka: funda /docs ngaphambi kokufunda okunye kuleli webhusayithi. I-API yincazelo eqiniso yento omkhiqizo oyenzayo, futhi zonke izibopho kulezi makhasi zihambisana nendlela noma uhlobo lwe-node ungayithola lapho. Uma isakhiwo seguquka, lezi makhasi aguquka.