API
Ii leat priváhta endpoint. Ii ge easet guovddáš vuosttas.
Eanet buot hámit leat guokte API: dokumeantá API mas don ožžot, ja áhččat API mii guovddáš siidduid siskkolas. Nubbi lea álo buoremus, ja dus ii leat vuoigatvuohta gáibidit dan. Dás leat okta, ja guovddáš lea dan klienta nugo eara-ge — mii lea rddjus min dihte, ja dan dihte buot maid don háliidat ráhkadit lea vejolaš.
Maid dán láhka duohtas vistti
Dat mearkkaša ahte siiddu sáhttá álo vuordit API lea rievttes, ii ge vuolgit dan birra okta heivvolaš bieldu. Beaivvi go siiddu dárbbaša maid almmolaš API ii sáhte addit, lea dat beaivi go API lea jearahallan, ja ráhkadus lea API.
Váldo lea ahte golbma eri klienta kusttá almosta eahpet. MCP server lea klienta. Dash-b tiila lea klienta. Iežat skripta lea klienta. Ii oktage lea nubbi luohká bargamin eará árvvu birra, go ii leat eará árvu.
Dokumeantán, ja geahpáduvvon
OpenAPI ráhkaduvvo /docs ja juohke route lea test mii lea dokumeantta ovdamearka. Dokumeanta mii čálluvvo eret koda birra vahkká gitta mánu; dokumeanta mii feaskara build go lea jearahallan, ii vahkka.
Sisačáliheapmi
Du castomo konta, authorization code flow PKCE — seamma konta maid don atnit dash-b ja eará bearrašii. Siiddu mii ii leat iežas servera vuosttas vuosttaš flow bures; dat lea maid flow lea huksejuvvon. Mašiidna-mašiidna bargui, prošeakta-scoped API čoavdda.
- 1Olbmot
/v1/contacts·/lists·/segments·/tags·/imports - 2Sisdoallu
/v1/creatives, validerehttin, ovdančájeheamis ja render juohke target - 3Automášuvdna
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4Sátta
/v1/campaigns, audience, materialise, schedule ja send eri stáhtain - 5Dahkke sisa
/v1/events— iežat aplikasuvnna dahkke, triggeran - 6Viestadus
/sender-identities·/domains·/apps·/webhooks - 7Logut
/v1/reports/*, ja/track/*juvding hostas
OpenAPI /docs/mcp seamma processas
Konvensuvnnat
Seamma hápmi nugo buot eará castomo bálvalusat
Dat máksá eanet go oinnus. Jos don gáibidat okta dán, don máhtát jo manne dát vástida, feaskara ja paginere.
Okta error envelope
Juohke feaskar lea seamma hápmi, stáblaš koda ja dieđáhus mii lea olbmo dihte. Ii oktage route ráhkada iežas vistti leat jearahallan.
Cursor pagination
Ii offsettat. Listu mii rievdaduvvo go don vázzit dan eai hiljá vuolgit dahjer maiddái ráddjet ruvddiid, mii offset pagination dagaha hiljá ja álo.
Idempotency čoavdagat
Juohke muterema routeas. Retry request don ii leat sihkar go lea beassan, ja ožžot seamma vástádusa ii nubbi kontakt, nubbi kampanja dahjer nubbi sáddehus.
Scoped prošeaktii
Token adresea okta tenant ja okta prošeakta, guhtet. Row-level security lea juohkejuvvon database siskkolas, ii muittuhussan lasihit clause.
Webhookat olggos
Signeruvvon, retry backoff, ja viestaduvvon unnimus okta geardde — dan dihte du endpoint galgá leat idempotent. Dahkke leat seamma sátnelistu raporttat atnit.
Sihkkun ja export
Kontakta sáhttá export dahjer sihkkut API bokte, ja sihkkun beassá juohke oarbbalaš bálvalussii mii leat koppe bearrašii iežas siskkolas lági bokte.
Buot maid guovddáš sáhttá dagahit, POST sáhttá dagahit.
Dahkat leat dán ovdamearka idjosat
Buot eará dán siiddus leat dán ovdamearka oahpahus. POST /v1/events lea dán geavaheaddji mii rievdadá produkta áiggoráhkadusa.
Du prográmma dieđu juo ollu mii ii leat márketing-reaidu sáhtte geahčat: gii gearddai onboarding, gii bohtai oahpahus, gii beassai rájáide, gii eksporterehtii dieđuid sotnobeivvi eahket. Sádde daid dahkkanan du iešguđet tokenain, ja juohkkas šaddá trigger, eavttu ja segmenta.
Eará čuovvu kontakt-máilmmis. Dahkat čuvvojit, ii goassege rievdaduvvojit; dat leat log mii buot produkta čuovvu. Funnel mii álggaha dahkkanan mii don defineret, ii leat integrášuvdna — dat lea seamma mekanisma message_opened atná, eará namain.
- 1Don sáddet dan
POST /v1/events— namma, kontakt, payload, idempotency-čoavdda. - 2Dat boahtáČuvvojuvvon kontakt-logii. Ii mihkkege eará dárbbaša dieđit ahte dat existere.
- 3Funnel álgáBuot funnel mii entry namaha dahkkanan, buot kontakt mii entry spec eavttu mielde.
- 4Eará funnelt gillet dan"Lea go dát dahkkanan dáhpahuvvan maŋimuš 14 beaivvi" lea dábálaš segmenta-predikahta.
- iJa dat loahpaha runsGoal-node mii namaha seamma dahkkanan loahpaha sequence diibmu go olmmái dahká ásahusa.
Du sánitDu token
Rájiid mat dárbbaša dieđit ovdal go don hukset
ClickSomo vurke golbma identifikahtora du birra — tenant, prošeakta ja geavaheaddji, opaque id:n — ja ii mihkkege eará. Ii beassansátn, ii profil, ii kárta, ii rehkenastus. Plan rájit boahtá nummariin: man ollu kontakt, man ollu sáddehus, man ollu generatiuvnna. Maksan sánit eai gáffe dan ráji mihkkege beliin.
Du kontaktat leat du iešguđet. Don leat data controller; mii leat processor. Ii leat geaidnu mii eará produktii sáhttá lohkat dahje čállit du kontakt-listtu, ja ii ingest-lána mii sáhttá atnit.
Jos don árvustallat dán duođalaččat: lohká /docs ovdal go lohkát eará dán neahttasiiddus. API lea duohta govvádus mii produkta dahká, ja buot váttis dán siidduin gávdnojit geaidnu dahje node-kind doppe. Go schema rievdaduvvo, dát siiddut rievdaduvvojit.