Te API
Kāore he wāhi motuhake. Kāore anō hoki mō te atanga.
He rua ngā API o te nuinga o ngā hua: tētahi kua tuhia māu, me tētahi e whakamahia ana e ō rātou mata anake. Ko te tuarua te mea pai ake, ā, kāore koe e āhei ki reira. Kei konei tētahi anake, ā, he kaihoko te atanga o taua API pērā i ētahi atu — he here tēnā ki a mātou, ā, koia te take e taea ai te hanga i ngā mea katoa e hiahia ana koe.
He aha te utu o taua ture
Ko te tikanga, ka tatari tētahi mata i ētahi wā mō te API kia tika, kāore e pehi ana ki tētahi āpure māmā i tua atu. Ko te rā e hiahia ana tētahi mata ki tētahi mea kāore e taea e te API tūmatanui, ko te rā e hē ana te API, ā, ko te whakatika ko te API.
Ko te hua, he iti noa te utu o ētahi e toru ngā kaihoko rerekē rawa. He kaihoko te ratonga MCP. He kaihoko tētahi porowhita dash-b. He kaihoko tō ake tuhinga kōrero. Kāore tētahi o rātou hei kirirā tuarua e pehi ana i tētahi mata i hangaia mō tētahi atu, nō te mea kāore he atu mata hei tuarua.
Kua tuhia, kua whakamahia
Ka whakaputaina te OpenAPI i te /docs, ā, he whakamātautau o ia ara, koia te tauira i roto i te tuhinga. Ka rerekē te tuhinga kua tuhia i waho o te waehere i roto i te marama kotahi; kāore te tuhinga ka hinga te hanga ina hē.
Te takiuru
Tō pūkete castomo, mā te rere whakamana me PKCE — koia te pūkete anake e whakamahia ana e koe mō dash-b me te whānau katoa. Ka pai te rere i tētahi whārangi kāore he tūmau ake; koia te take i hangaia ai te rere. Mō te mahi mīhini-ki-mīhini, he matua API e āpitihia ana ki tētahi kaupapa.
- 1Ngā tāngata
/v1/contacts·/lists·/segments·/tags·/imports - 2Ngā ihirangi
/v1/creatives, me te manatoko, te akoranga me te whakaatu mō ia whāinga - 3Mahi aunoa
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4Pāho
/v1/campaigns, me te hunga whakarongo, te whakatinana, te wāhere me te tuku hei mahi motuhake - 5Ngā takahia e uru mai
/v1/events— ngā takahia o tō ake tono, hei whakawhakaawe - 6Te tuku
/sender-identities·/domains·/apps·/webhooks - 7Ngā tau
/v1/reports/*, me te/track/*i te kaiwhakarau
OpenAPI i te /docs/mcp i te tukanga kotahi
Ngā tikanga
Te āhua anake o ia ratonga castomo kē
He nui ake te hiranga o tēnei i tāna āhua. Mēnā kua karangia e koe tētahi o ēnei, kua mōhio kē koe me pēhea te whakautu, te hinga me te whārangihanga o tēnei.
Kotahi te kāwai hapa
He āhua ōrite o ia hinga, he waehere pūmau me tētahi karere mō te tangata. Kāore he ara e whakaatu i tōna ake mamae.
Te whārangihanga tohu
Ehara i ngā rārangi. Kāore he rārangi e huri ana i a koe e hīkoi ana e peke noa, e tāpiri noa rānei i ngā rārangi, he mea e mahia noatia ai e te whārangihanga rārangi.
Ngā matua auau-ana
I ia ara e whakarerekē ana. Tukuna anō tētahi tono kāore koe i tino mōhio kua tae, ā, ka whiwhi i te whakautu ōrite, kāore he kirirā tuarua, he kaupapa tuarua, he tuku tuarua.
E āpitihia ana ki tētahi kaupapa
E whai ana tētahi tohu ki tētahi kiritaki me tētahi kaupapa, e rua. Ka whakatinana te haumaru taumata-rārangi i roto i te pātengi raraunga anake, ehara i te maumahara ki te tāpiri i tētahi rerenga.
Ngā webhook e puta mai ana
Kua waitohuhia, kua whakamātauria anō me te tāwai, ā, kua tae atu i te iti rawa kia kotahi — nō reira me noho tapiri-kore tō pae whiwhinga hoki. He rite ngā kaupapa o ngā takahē ki te reo o ngā ripoata.
Te mukunga me te kawenga atu
Ka taea te kawe atu, te muku rānei i tētahi kaiwhakapā mā te API, ā, ka tae te mukunga ki ia ratonga tuakana e pupuhi ana i tētahi kape, mā te ara o roto a te whānau tonu.
He mea katoa e taea ana e te atanga, ka taea e tētahi POST.
Ko ngā takahē te wāhanga whakamīharo
He wāhanga pāpāho-noa i te nuinga o tēnei whārangi, pērā i tō tūmanako. Ko POST /v1/events te ara e huri ana i te take o te hua.
E mōhio ana tō tonotono i ētahi mea kāore he taputapu hokohoko e āhei ana te kite: nā wai i oti te whakaurunga, nā wai i karanga i tētahi hoa mahi, nā wai i pā ki tētahi here, nā wai i kawe i ō rātou raraunga i tētahi ahiahi Rātapu. Tukuna hei takahē mā tō ake tohu, ā, ka noho ia hei whakaara, hei herenga, hei wehenga.
Ka whai mai te toenga mai i te tauira kaiwhakapā. Ka tāpiritia ngā takahē, kāore e whakatikangia; ko te rārangi rātou te hua katoa e tū ana. He tāwai e whakaara ana i tētahi takahē i tautuhingia e koe, ehara i tētahi hononga — ko te mīhini anō a message_opened, he ingoa rerekē kei roto.
- 1Ka tukuna e koe
POST /v1/events— he ingoa, he kaiwhakapā, he pātoto, he matua kore-tukuruatanga. - 2Ka taeKa tāpiria ki te rārangi o te kaiwhakapā. Kāore he mea e hiahia ana ki te mōhio he mea tōna.
- 3Ka tīmata tētahi tāwaiHe tāwai anō tōna tomonga e tapa ana i taua takahē, mō tētahi kaiwhakapā e whakaaetia ana e tōna tohu tomonga.
- 4Ka peke ētahi atu tāwai ki rungaHe tohu wehenga noa te pātai "Kua pā tēnei takahē i ngā rā 14 kua pahure ake nei".
- iĀ, ka whakamutunga i ngā rārangi mahiKa whakamutunga tētahi hōtaka e tētahi pūtau whāinga e tapa ana i taua takahē anō, i te wā tonu ka mahi te tangata i te mea.
Tō reo kōreroTō tohu
He here e pai ana kia mōhio koe i mua i tō hanga
Ka penapena a ClickSomo i ētahi toru tohu motuhake mōu — he kiritahi, he kaupapa, he kaiwhakamahi, hei tohu kore-mārama — ā, kāore he mea atu. Kāore he kupuhipa, he kōtaha, he kāri, he puka utu. Ka tae ngā here o te mahere hei tau: e hia ngā kaiwhakapā, e hia ngā tukunga, e hia ngā whakatupunga. Kāore te reo o te utu e whiti i taua raina, i ētahi taha rāua ko tētahi.
Nōu ō kaiwhakapā. Ko koe te kaiwhakahaere raraunga; mātou te kaiwhakatuki. Kāore he ara e āhei ai tētahi atu hua o te whānau ki te pānui, te tuhi rānei i tō rārangi kaiwhakapā, ā, kāore he ara whakauru mō tētahi.
Mēnā he tino whakatau tō aroaro: pānuihia /docs i mua i tō pānui atu i ētahi atu wāhanga o tēnei paetukutuku. Ko te API te whakaahua pono o te mahi a te hua, ā, ka hono ia kīanga o ēnei whārangi ki tētahi ara, ki tētahi momo pūtau e kitea ai. Ka huri te tauira raraunga, ka huri ēnei whārangi.