An API
Níl aon críochphointe príobháideach ann. Ní fiú fiú don chomhéadan féin.
Tá dhá API ag formhór na dtáirgí: an ceann doiciméadaithe a thairgtear duit, agus an ceann suimiúil a úsáideann a scáileáin féin. Is fearr i gcónaí an ceann dara, agus ní cheadaítear duit a bheith ina thimpeall riamh. Anseo tá ceann amháin ann, agus is cliant de an comhéadan ar nós aon rud eile — is srian é sin orainn, agus is é an fáth gur féidir gach rud a theastaíonn uait a thógáil.
Cad a chosnaíonn an riail sin i ndáiríre
Ciallaíonn sé go gcaithfidh scáileán fanacht uaireanta go mbeidh an API ceart, seachas dul timpeall air le haghaidh aon réimse áisiúil amháin. An lá a theastaíonn scáileán rud nach féidir leis an API poiblí a thabhairt dó is é sin an lá a bhfuil an API mícheart, agus is é an leigheas an API.
Is é an t-aisíocaíocht nach gcosnaíonn trí chliant an-difriúil beagnach aon rud breise. Is cliant é an freastalaí MCP. Is cliant é tíl dash-b. Is cliant é do script féin. Ní saoránach den dara grád aon cheann acu, ag obair timpeall ar dhromchla a dhearadh do dhuine eile, mar níl aon dromchla eile ann le bheith sa dara háit dó.
Doiciméadaithe, agus in úsáid
Gintear OpenAPI ag /docs agus tá tástáil ag gach bealaí atá mar shampla na doiciméadaithe. Driftaíonn doiciméadú a scríobhtar ar leith ón gcód laistigh de mhí; ní dhéanann doiciméadú a theipeann ar an tógáil nuair atá sé mícheart.
Ag síniú isteach
Do chuntas castomo, tríd an sreabhadh údaraithe le PKCE — an cuntas céanna a úsáideann tú le haghaidh dash-b agus an chuid eile den teaghlach. Rithíonn leathanach nach bhfuil freastalaí féin aige an sreabhadh sin go foirfe; is é sin ar a ndearadh an sreabhadh. Le haghaidh oibre meaisín-go-meaisín, eochair API scóipthe ar thionscadal.
- 1Daoine
/v1/contacts·/lists·/segments·/tags·/imports - 2Ábhar
/v1/creatives, le bailíochtú, réamhamharc agus reandáil in aghaidh an sprioc - 3Uathoibriú
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4Craoladh
/v1/campaigns, le lucht féachana, ábharú, sceidealú agus seoladh mar chéimeanna ar leith - 5Imeachtaí isteach
/v1/events— imeachtaí d'fheidhmchláir féin, mar spreagthóirí - 6Seachadadh
/sender-identities·/domains·/apps·/webhooks - 7Uimhreacha
/v1/reports/*, agus/track/*ar an óstach rianaithe
OpenAPI ag /docs/mcp ar an bpróiseas céanna
Coinbhéinsí
An cruth céanna le gach seirbhís castomo eile
A bhfuil níos mó tábhachta leis ná mar a shíltear. Má ghlaoíonn tú cheana féin ar cheann díobh seo, tá a fhios agat cheana féin conas a fhreagraíonn, a theipeann agus a leathanaíonn an ceann seo.
Aon chlár earráide amháin
Tá an cruth céanna ag gach teip, cód cobhsaí agus teachtaireacht atá dírithe ar dhuine. Ní chumann aon bhealaí a bhealaí féin míshástachta.
Leathanaigh chúrsóra
Ní fritháirimh. Ní fadaíonn ná athdhéanann liosta a athraíonn agus tú ag siúl tríd sraitheanna go ciúin, rud a dhéanann leathanaigh fhritháirimh go ciúin agus go leanúnach.
Eochracha idempotency
Ar gach bealaí athraitheach. Atriail iarratas nach bhfuil tú cinnte gur tháinig sé agus faigh an freagra céanna seachas dara teagmháil, dara feachtas nó dara seoladh.
Scóipthe ar thionscadal
Aimsíonn comharbhaíon aon tiománaí amháin agus aon thionscadal amháin, an dá cheann. Cuirtear slándáil leibhéal-sraithe i bhfeidhm sa bhunachar sonraí féin, ní trí cuimhne a bheith ort claoma a chur leis.
Webhooks amach
Sínithe, atriailte le cúlchúltas, agus seachadta uair amháin ar a laghad — mar sin ba chóir go mbeadh do chríochphointe idempotent freisin. Is é an stór focal céanna a úsáideann na tuarascálacha atá sna himeachtaí.
Scriosadh agus easpórtáil
Is féidir teagmhálaí a easpórtáil nó a scriosadh tríd an API, agus sroicheann scriosadh gach seirbhís deirfiúr a bhí cóip aici tríd an bhealaí inmheánach féin den chlann.
Is féidir le POST aon rud a dhéanann an comhéadan.
Is iad na himeachtaí an chuid shuimiúil
Is píopaíocht an gach rud eile ar an leathanach seo a bheifeí ag súil leis. Is é POST /v1/events an bealach a athraíonn cad is cuspóir don táirge.
Tá a fhios ag d'iarratas cheana féin rudaí nach féidir le haon uirlis mhargaíochta a fheiceáil: cé a chríochnaigh an onboarding, cé a thug cuireadh do chomhghleacaí, cé a bhuail teorainn, cé a easpórtáil a gcuid sonraí tráthnóna Domhnach. Foilsigh iad sin mar imeachtaí le do chomhartha féin, agus éiríonn gach ceann acu ina spreagadh, ina choinníoll agus ina shraith.
Síleann an chuid eile ó mhúnla an teagmhálaí. Cuirtear imeachtaí leis, ní eagraítear iad riamh; is é sin an log a dtacaíonn an táirge ar fad air. Ní comhtháthú é funnel a spreagtar ag imeacht a d'fhéinigh tú — is é an meicníocht céanna é a úsáideann message_opened, le hainm eile ann.
- 1Foilsíonn tú é
POST /v1/events— ainm, teagmhálaí, ualach, eochair idempotence. - 2Tagann sé i dtírCuirtear le log an teagmhálaí é. Ní gá d'aon rud eile a bheith ar an eolas go bhfuil sé ann.
- 3Tosaíonn funnelAon funnel a ainmníonn an t-imeacht sin mar iontráil, d'aon teagmhálaí atá incháilithe faoina sonraíocht iontrála.
- 4Brainseann funnels eile airIs é "An dtarlaigh an t-imeacht seo sna 14 lá seo caite" gnáth-thuar teorann do shraith.
- iAgus stopann sé rithíStopann nód sprioc a ainmníonn an t-imeacht chéanna seicheas an nóiméad a dhéanann an duine an rud.
Do stór focalDo chomhartha
Teorainneacha atá fiú a bheith ar eolas agat sula dtógann tú
Stórálann ClickSomo trí aitheantóir fút — tenant, tionscadal agus úsáideoir, mar ids doiléir — agus faic eile. Gan focal faire, gan próifíl, gan cárta, gan sonrach. Tagann teorainneacha an phlean mar uimhreacha: cé mhéad teagmhálaí, cé mhéad seoladh, cé mhéad giniúint. Ní théann foclóir íocaíochta thar an líne sin sa treo ar bith.
Is leatsa do theagmhálaithe. Is tú an rialtóir sonraí; is muidne an próiseálaí. Níl aon bhealach ar féidir le táirge eile sa chlann do liosta teagmhálaithe a léamh nó a scríobh, agus níl aon bhealaí ionduchtaithe ann le húsáid.
Má tá tú ag measúnú seo go dáiríre: léigh /docs sula léann tú a thuilleadh den suíomh gréasáin seo. Is é an API an cur síos macánta ar a ndéanann an táirge, agus tagann gach éileamh ar na leathanaigh seo le bealach nó le cineál nóid a aimsíonn tú ansin. Nuair a athraíonn an scéimé, athraíonn na leathanaigh seo.