I-API

Akukho ndawo yangasese. Akukho nangokwelinterface.

Iimveliso ezininzi zinamafutathane amabini: eyona ibhalwe ngokucacileyo onikezelwa yona, kunye neyona intle esetyenziswa kwiikrini zayo. Eyona ibalulekileyo ihlala ingcono, kwaye awuvumelekanga kuyo. Apha kukho enye, kwaye i-interface ngumthengi wayo njengento nganye — oku kusibopha kuthi, kwaye yisizathu sokuba yonke into ufuna ukuyakha iyakwazi.

Into ethileyo eya kuthi ngokwenene

Kuthetha ukuba isikrini ngamanye amaxesha kufuneka silinde i-API ukuba ichanekile, endaweni yokudlula kuyo ngenxa yenketho enye. Usuku isikrini esifuna into i-API yonke ayinakuyinika lusuku i-API engachanekanga, kwaye isisombululo yi-API.

Inzuzo kukuba amathathu amathengi ahlukileyo akhawulela akukho nto ithe yongezelelwa. Iseva yeMCP ngumthengi. Ithayili ye-dash-b ngumthengi. Iskripthi sakho ngumthengi. Akukho nawaphi abangabasekondi abasebenza ngesikhokelo esenzelwe omnye umntu, kuba akukho sikhele esinye sokuba ngabasekondi kuso.

Ibhaliwe, kwaye isetyenzisiwe

I-OpenAPI yenziwa kwi-/docs kwaye yonke indlela inovavanyo oluyisiboniso kuxwebhu. Uxwebhu olubhalwe ngokwahlukileyo kwi-khowudi luyatshintsha ngaphakathi kwenyanga; uxwebhu olusilela kwisakhiwo xa lungachanekanga alutshintshi.

Ukungena

I-akhawunti yakho ye-castomo, nge-authorization code flow ne-PKCE — i-akhawunti efanayo oyisebenzisayo kwi-dash-b nakwezinye zosapho. Iphepha elingenaseva yalo lisebenzisa lo mkhondo kakuhle; yinto owamkelwa ngayo. Kwimisebenzi phakathi kwemishini, isitshixo se-API esijolise kwiprojekthi.

Isikhokeloapi.clicksomo.com

1Abantu/v1/contacts · /lists · /segments · /tags · /imports
2Umxholo/v1/creatives, nokuqinisekiswa, ukubonisa kunye nokunika ngokwehlabathi
3Okuzenzekelayo/v1/funnels · /funnels/:id/versions · /runs · /simulate
4Usasazo/v1/campaigns, nabadla-nkxaso, ukwenza, ukucwangcisa kunye nokuthumela njengamanyathelo ahlukileyo
5Iziganeku zangaphakathi/v1/events — iiganeku zesicelo sakho, njengokubangela
6Ukufikelela/sender-identities · /domains · /apps · /webhooks
7Amanani/v1/reports/*, kunye /track/* kwiseva yokulandelela

I-OpenAPI kwi-/docs/mcp kwinqubo efanayo

Iimvume

Isimo esifanayo njengenkonzo ye-castomo nganye

Oku kubalulekile ngaphezu kokuba kucace. Ukuba usele wabiza enye yalezi, usazi ukuba le ndlela iphendula njani, isilela njani kwaye ipaginate njani.

Isiqendu sesiphoso esinye

Ukwehluleka ngakunye kunesimo esifanayo, ikhowudi ezinzileyo nomyalezo owenzelwe umntu. Akukho ndlela idalisa indlela yayo yokungathandabuzi.

Ukupaginatha nge-cursor

Hayi i-offsets. Uluhlu olutshintsha ngelixa uluhamba aludluli okanye aphinde imigca, oko kwenziwa yipaginathi ye-offset ngokuthuleka nokungapheli.

Izitshixo zokungatshintshi

Kwindlela nganye etshintshayo. Phinda isicelo ongaqinisekanga ukuba safika kwaye ufumane impendulo efanayo endaweni yokudibana okwesibini, icam lesibini okanye ukuthumela kwesibini.

Kujolise kwiprojekthi

Itokheni ijolisa kumthengi omnye nakwiprojekthi enye, zombini. Ukhuseleko lwezinga lomqolo luqinisekiswa kwindlela yedatha ngokwayo, hayi ngokukhumbula ukongeza isigqibo.

IiWebhooks eziphumayo

Kusayinwe, kuphindwa imizamo nge-backoff, kwaye kufuneka kufike kanye okanye ngaphezulu — ngoko i-endpoint yakho kufuneka ibe yiyona nto ingatshintshiyo xa iphinda. Ii-events zisekwisigama esifanayo seengxelo.

Ukucinywa kunye nokuthunyelwa ngaphandle

Unxibelelwano lunokuthunyelwa ngaphandle okanye lucinywe nge-API, kwaye ukucinywa kufikelela kwinke iinkonzo zasekhaya ezigcina ikhophi ngeendlela zangaphakathi zesibini.

Yonke into esinokuyenza ngokujonga, i-POST inokuyenza.

Ii-events yindlela eyona inomdla

Yonke into enye kweli phepha yimisebenzi oyilindele. POST /v1/events yindlela etshintsha into elimele ukuba yimveliso.

Isicelo sakho sele siyazi izinto ezingabonwa zizixhobo zokuthengisa: ngubani ogqibile ukuqalisa, ngubani omemele omnye umsebenzi, ngubani ofikelela kumda, ngubani othumela idatha yakhe ngoLwesine emva kwemini. Thumela ezo zinto nge-token yakho, kwaye nganye iba yisiphelo, imeko, kunye neqela.

Okunye kulandela imodeli yonxibelelwano. Ii-events zongezwa, azihlelwa; zilog elipheleleyo elimele yonke imveliso. I-funnel eqalisa nge-event oyichazileyo ayisiyo intlanganiso — yindlela efanayo message_opened esebenzisa ngayo, ngegama elahlukileyo kuyo.

I-event yakho iba yifunnelapi_event

1UyithumelaPOST /v1/events — igama, unxibelelwano, iphakheji, isitshixo sokungaphindi.
2IfikaYongezwa kwilog yonxibelelwano. Akukho nto enye ifuneka yazi ukuba ikhona.
3I-funnel iqalaNayiphi na i-funnel enokungena kule event, kwanabani na abavumelekileyo ngokwespec yayo.
4Ezinye ii-funnel ziyahlukanisa ngayo"Ingaba le event yenzekile kwiiintsuku ezili-14 zokugqibela" yimeko eqhelekileyo yeqela.
iKwaye iphelisa iimjikelezoI-node yenjongo echaza le event iyeka ukuhamba kwexesha ngoko nangoko umntu akwenza into.

Isigama sakhoI-token yakho

Iimida ezifanele ukwaziwa phambi kokuba wakhe

ClickSomo igcina iintlobo ezintathu zeempawu ngawe — itenanti, iprojekthi nomsebenzisi, njengee-id ezingabonakaliyo — kwaye akukho nto enye. Akukho mthambo, akukho profayili, akukho kadethi, akukho invoyisi. Iimida zecandelo zifika njamanani: ingaba mangaphi amanxibelelwano, mangaphi othumelo, mangaphi amazwi. Iilwimi zokubhatala azidliki lo mda nangakumbi nanganye.

Amanxibelelwano akho ngawakho. Ungulawuli wedatha; thina singabasebenzisi. Akukho ndlela enokwenza imveliso enye yosapho ifunde okanye ibhale uluhlu lamanxibelelwano akho, kwaye akukho ndlela yokufaka enokuyisebenzisa.

Ukuba uhlalutya oku ngobulumko: funda /docs phambi kokuba ufunde okunye kweli sayithi. I-API yinkcazelo inyaniso yento imveliso iyenzayo, kwaye zonke iingxelo kwamaphepha aya zidibana nendlela okanye uhlobo lwe-node ungayifumana apho. Xa iskema itshintsha, la maphepha atshintsha.