API

Hakuna kiunganishi cha faragha. Hata kwa kiolesura chenyewe.

Bidhaa nyingi zina API mbili: ile iliyoelezwa inayokupewa, na ile ya kuvutia ambayo skrini zao wenyewe hutumia. Ya pili daima ni bora zaidi, na huruhusiwi kuingia karibu nayo kabisa. Hapa kuna moja tu, na kiolesura ni mteja wake kama kitu chochote kingine — hii ni kikwazo kwetu, na sababu kila kitu unachotaka kujenga kinawezekana.

Gharama halisi ya kanuni hiyo

Inamaanisha kwamba skrini mara nyingine lazima isubiri API iwe sahihi, badala ya kuzunguka ili kupata uga mmoja unaofaa. Siku skrini inahitaji kitu API ya umma isiyoweza kutoa ndiyo siku API ipo vibaya, na suluhisho ni API yenyewe.

Faida ni kwamba wateja watatu tofauti kabisa hugharimu karibu hakuna ziada. Seva ya MCP ni mteja. Kipande cha dash-b ni mteja. Skripti yako mwenyewe ni mteja. Hakuna anayefanya kazi ya daraja la pili kuzunguka uso ulioundwa kwa mtu mwingine, kwa sababu hakuna uso mwingine wa kuwa wa pili kwake.

Imeelezwa, na inatumika

OpenAPI inazalishwa kwenye /docs na kila njia ina jaribio ambalo ni mfano katika nyaraka. Nyaraka zilizoandikwa tofauti na msimbo hubadilika ndani ya mwezi; nyaraka zinazoshindwa ujenzi zikikosea haziubadiliki.

Kuingia

Akaunti yako ya castomo, kwa mtiririko wa msimbo wa idhini na PKCE — akaunti ile ile unayotumia kwa dash-b na wengine wa familia. Ukurasa usio na seva yake unafanya mtiririko huo vizuri kabisa; ndiyo ulioundwa kwa hilo. Kwa kazi ya mashine-kwa-mashine, funguo ya API ya kiwango cha mradi.

Usoapi.clicksomo.com

1Watu/v1/contacts · /lists · /segments · /tags · /imports
2Yaliyomo/v1/creatives, pamoja na uhakiki, hakiki-onyesho na uonyeshaji kwa kila lengwa
3Uendeshaji otomatiki/v1/funnels · /funnels/:id/versions · /runs · /simulate
4Utangazaji/v1/campaigns, pamoja na hadhira, kuweka wazi, kupanga ratiba na kutuma kama hatua tofauti
5Matukio yanayoingia/v1/events — matukio ya programu yako mwenyewe, kama vichochezi
6Uwasilishaji/sender-identities · /domains · /apps · /webhooks
7Namba/v1/reports/*, na /track/* kwenye mwenyeji wa ufuatiliaji

OpenAPI kwenye /docs/mcp kwenye mchakato ule ule

Mila

Muundo ule ule kama huduma zote nyingine za castomo

Ambayo ina umuhimu zaidi kuliko inavyosikika. Ukiwa tayari unaita mojawapo ya hizi, tayari unajua jinsi hii inajibu, inashindwa na inagawisha kurasa.

Bahasha moja ya makosa

Kila kushindwa kuna muundo ule ule, msimbo imara na ujumbe unaolenga mtu. Hakuna njia inayobuni njia yake ya kukasirika.

Ugawanyaji wa kurasa kwa kidole-cha-mwisho

Si mapumziko. Orodha inayobadilika ukiwa unaiTembea hairukwi wala kurudia mistari kimya kimya, ambayo ugawanyaji wa mapumziko hufanya kimya kimya na mara kwa mara.

Funguo za idempotency

Kwenye kila njia inayobadilisha data. Jaribu tena ombi usiolipa hakika na upate jibu moja badala ya mawasiliano ya pili, kampeni ya pili au utumaji wa pili.

Imefungwa kwa mradi mmoja

Tokeni inahusu mpangaji mmoja na mradi mmoja, vyote viwili. Usalama wa kiwango cha safu unatekelezwa ndani ya hifadhidata yenyewe, sio kwa kukumbuka kuongeza kifungu.

Webhooks zinazotoka

Zilizosainiwa, hurudiwa kwa backoff, na kufikishwa angalau mara moja — hivyo endpoint yako pia inapaswa kuwa na idempotent. Matukio hayo ni msamiati uleule unaotumiwa na ripoti.

Kufuta na kuingiza data

Mwasiliani anaweza kuingizwa au kufutwa kupitia API, na kufutwa kunafika kwenye kila huduma ndugu iliyokuwa na nakala kupitia njia ya ndani ya familia yenyewe.

Kila kitu kiolesura kinachoweza kufanya, POST inaweza kufanya.

Matukio ndiyo sehemu ya kupendeza

Kila kitu kingine kwenye ukurasa huu ni miundombinu unayoitazamia. POST /v1/events ni njia inayobadilisha lengo la bidhaa.

Programu yako tayari inajua mambo ambayo zana yoyote ya uuzaji haiwezi kuona: nani alimaliza onboarding, nani alikaribisha mwenzake, nani aligusa kikomo, nani alitangaza data zake Jumapili mchana. Tuma hayo kama matukio kwa tokeni yako mwenyewe, na kila moja inakuwa kichocheo, sharti na sehemu (segment).

Yaliyobaki yanafuata kutoka kwa mfano wa mwasiliani. Matukio yanaongezwa, hayakuhaririwa kamwe; ni kumbukumbu ambayo bidhaa nzima inategemea. Funnel inayoanzishwa na tukio ulilofafanua si muunganisho — ni utaratibu uleule unaotumiwa na message_opened, tu kwa jina tofauti ndani yake.

Tukio lako linakuwa funnelapi_event

1UnalitumaPOST /v1/events — jina, mwasiliani, payload, na funguo ya idempotency.
2LinawasiliLinaongezwa kwenye kumbukumbu ya mwasiliani. Hakuna kitu kingine kinachohitaji kujua lipo.
3Funnel inaanzaFunnel yoyote ambayo ingizo lake linataja tukio hilo, kwa mwasiliani yoyote anayestahili chini ya vipimo vya ingizo lake.
4Funnel nyingine zinagawika juu yake"Je, tukio hili limetokea ndani ya siku 14 zilizopita" ni sharti la kawaida la segment.
iNa linaisha mizungukoNodi ya lengo inayotaja tukio hilo hilo inazuia mfululizo mara moja mtu anapofanya jambo hilo.

Msamiati wakoTokeni yako

Mipaka ya kufahamu kabla ya kujenga

ClickSomo inahifadhi vitambulisho vitatu kuhusu wewe — mpangaji, mradi na mtumiaji, kama ids zisizo wazi — na hakuna kingine. Hakuna nenosiri, hakuna wasifu, hakuna kadi, hakuna ankara. Vikomo vya mpango vinakuja kama namba: ni mawasiliani mangapi, ni matumaji mangapi, ni uzalishaji mangapi. Msamiati wa malipo huvuka mstari huo pande zote mbili.

Mawasiliani yako ni yako. Wewe ndiye mdhibiti wa data; sisi ni wasindikaji. Hakuna njia ambayo bidhaa nyingine ya familia inaweza kusoma au kuandika orodha yako ya wawasiliani, wala njia ya kuingiza data itakayotumiwa nayo.

Ikiwa unafanya tathmini hii kwa umakini: soma /docs kabla ya kusoma zaidi ya tovuti hii. API ni maelezo ya kweli ya kile bidhaa inachofanya, na kila madai kwenye kurasa hizi yanahusiana na njia au aina ya nodi unayoweza kuipata hapo. Wakati muundo unabadilika, kurasa hizi zinabadilika.