An API
N'eus ket a dibenn prevez. Ket zoken evit an etrefas.
An darn vrasañ eus ar c'henderc'hadoù o deus daou API : an hini deskrivet kinniget deoc'h, hag an hini ispisial implijet gant o skrammoù dezho. An eil a zo atav gwelloc'h, ha biken ne vezot aotreet da dostaat outi. Amañ ez eus unan hepken, hag an etrefas a zo un arval anezhi evel pep tra all — ur bevenn evit ac'hanomp eo, hag an abeg eo posupl sevel pep tra a fell deoc'h.
Ar pezh a koust gwirion ar reolenn-se
Talvezout a ra e rank ur skramm gortoz a-wechoù ma vo reizh an API, kent mont en-dro tro-dro dezhi evit ur vaezienn aesaat. An deiz ma ezhomm ur skramm un dra n'hall ket an API foran reiñ eo an deiz ma 'z eo fall an API, ha ar reizhadur eo an API.
Ar gounid eo teir arval disheñvel-mat a goust tost netra ouzhpenn. An dafariad MCP a zo un arval. Ur tilek dash-b a zo un arval. Ho skript deoc'h a zo un arval. Hini ebet n'eo ur c'heoded eil-renk o vont en-dro tro-dro ur gorread savet evit un den all, peogwir n'eus ket a gorread all da vezañ eil outañ.
Deskrivet, ha lakaet da labourat
OpenAPI a vez ganet e /docs ha pep hent a zo un esae a zo ar skouer e-barzh an teuliadur. Un teuliadur skrivet dispartiet diouzh ar c'hod a zibell e-barzh ur miz ; un teuliadur a c'hwit ar sevel pa 'z eo fall ne zibell ket.
Kevreañ
Ho kont castomo, dre ar gwazadur aotren gant PKCE — ar memes kont a implijit evit dash-b hag ar re all eus ar familh. Ur bajenn hep servijer dezhi a c'hell implijout ar gwazadur-se mat-tre; evit se eo bet savet. Evit labour mekaninez-da-vamekaninez, un alc'hwez API liammet ouzh ur raktres.
- 1Tud
/v1/contacts·/lists·/segments·/tags·/imports - 2Endalc’had
/v1/creatives, gant gwiriañ, rakwelet ha skrammañ dre sibl - 3Emluskadur
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4Skignañ
/v1/campaigns, gant ar selaouerien, ar c'henderc'hañ, ar steuñviñ hag ar c'has evel pazennoù disheñvel - 5Darvoudoù o tont
/v1/events— darvoudoù ho arload deoc'h, evel lañserioù - 6Kas d'an hevelep
/sender-identities·/domains·/apps·/webhooks - 7Niveroù
/v1/reports/*, hag/track/*war an ostiz heuliañ
OpenAPI war /docs/mcp war ar memes argerzh
Boazioù
Ar memes stumm hag pep servij castomo all
Ar pezh a bouez muioc'h eget na seblant. Ma vezit o galv unan anezho dija, e ouzit dija penaos e respont, e c'hwit hag e pajenna hennezh.
Un golier fazi hepken
Pep c'hwitadenn he deus ar memes stumm, ur c'hod stabil hag ur gemennadenn evit un den. Hini ebet eus ar hentoù ne ijinañ he doare dezhi bezañ displijet.
Pajennañ dre gursor
Ket gant digorennoù. Ul listenn a cheñch en ur heuliañ anezhi ne lam ket e linennoù pe ne adlenn ket anezhe en diskrign, ar pezh a ra ar pajennañ dre digorenn diouzh an tu kuzh ha dizehan.
Alc'hwezioù idempotentiezh
War pep hent a cheñch traoù. Adkasit ur goulenn n'oc'h ket sur eo degouezhet ha kaout ar memes respont kentoc'h eget un eil darempred, un eil koulzad pe un eil kas.
Bevennet d'ur raktres
Un token a veneg un degemerer hag ur raktres, an daou. Surentez live al linennoù a zo lakaet e pleustr en diaz roadennoù end-eeun, ket en ur soñj ouzhpennañ un diviz.
Webhookoù ez-eeun
Sinerezh, adkaset gant un talmadur, ha kaset da vihanañ ur wech — setu perak e tle ho talbenn bezañ idempotent ivez. An darvoudoù a zo ar memes geriaoueg hag ar raportoù.
Dilemel hag ezporzhiañ
Un darempred a c'hell bezañ ezporzhiet pe dilamet dre an API, hag un dilemel a dizh pep servij c'hoar a zalche un eilenn dre hent diabarzh ar familh.
Pep tra a c'hell ar etrefas ober, ur POST a c'hell ober.
An darvoudoù a zo ar perzh dedennus
Pep tra all war ar bajenn-mañ a zo santer a c'hortozfec'h. POST /v1/events eo an hent a cheñch perzh ar produ.
Ho arload a ouez traoù dija na c'hell anaveziñ an ostilhoù bruderezh ebet: piv en deus echuet an degemer, piv en deus pedet ur c'henlabourer, piv en deus tizhet un harz, piv en deus ezporzhiet e roadennoù d'ar Sul goude merenn. Kasit anezhe evel darvoudoù gant hoc'h token deoc'h, ha pep hini anezhe a zeu da vezañ ul lañser, un diviz hag un isrann.
Ar peurrest a heul ar model darempred. An darvoudoù a vez ouzhpennet, kemmet morse; int eo ar c'hazetenn a zalc'h ar produ a-bezh. Un funil a lañs war un darvoud hoc'h hini n'eo ket un enteuzadur — ar memes mekanik eo hag hini message_opened, gant un anv all ennañ.
- 1E kasit
POST /v1/events— un anv, un darempred, un danvez, un alc'hwez idempotentiezh. - 2Degouezhet e raOuzhpennet da gazetenn an darempred. Tra ebet all a rank gouzout ez eus anezhañ.
- 3Ur funil a grogForpenn bennak a ra e enank menegout an darvoud-se, evit an darempred bennak a zo aotreet gant spisaadur e enank.
- 4Forpennoù all a vez rannet dioutañ"Ha c'hoarvezet eo an darvoud-se e-barzh an 14 devezh diwezhañ" zo un divinadenn segmant ordinal.
- iHa paouez a ra ar redadegoùUn dugoulenn a ra meneg eus an hevelep darvoud a baouez un heuliad diouzhtu pa ra an den an dra-se.
Ho geriaouegHo jedouer
Bevennoù a zo mat gouzout a-raok sevel
ClickSomo a vir tri anaouder diwar-benn ac'hanoc'h — un tenant, ur raktres hag un implijer, evel idioù dizimez — ha netra ken. Ket ger-tremen, ket profil, ket kartenn, ket fakturenn. Bevennoù ar raktres a erru evel niveroù: petra a zarempredoù, petra a gasadennoù, petra a c'heneladurioù. Geriaoueg ar paeañ ne dreuz ket al linenn-se e forzh peseurt tu.
Ho darempredoù a zo hoc'h hini. C'hwi eo ar rener roadennoù; ni eo ar c'hefridier. N'eus hent ebet gant e c'hallfe ur produ all eus ar familh lenn pe skrivañ ho roll darempredoù, ha n'eus hent degemer ebet evitañ da implijout.
Ma 'z oc'h o priziañ an dra-se en doare sirius: lennit /docs a-raok lenn muioc'h c'hoazh eus al lec'hienn-mañ. An API eo an deskrivadur onest eus ar pezh a ra ar produ, ha kement disklêriadur war ar pajennoù-mañ a glot gant un hentenn pe ur seurt dugoulenn a gavit eno. Pa cheñch ar skeudenn, ar pajennoù-mañ a cheñch.