API
Ne postoji privatna krajnja tačka. Čak ni za interfejs.
Većina proizvoda ima dva API-ja: dokumentovani koji Vam nude, i onaj zanimljiviji koji koriste njihovi sopstveni ekrani. Drugi je uvek bolji, i nikada Vam se ne dozvoljava da mu priđete. Ovde postoji samo jedan, a interfejs je njegov klijent kao i sve ostalo — što je ograničenje za nas, i razlog zašto je sve što želite da izgradite moguće.
Šta to pravilo zaista košta
Znači da ekran ponekad mora da sačeka da API bude ispravan, umesto da ga zaobiđe zbog jednog zgodnog polja. Dan kada ekran treba nešto što javni API ne može da mu da, to je dan kada je API pogrešan, i rešenje je u API-ju.
Prednost je to što tri vrlo različita klijenta ne koštaju skoro ništa dodatno. MCP server je klijent. Tile na kontrolnoj tabli je klijent. Vaš sopstveni skript je klijent. Ni jedan od njih nije građanin drugog reda koji zaobilazi površinu dizajniranu za nekog drugog, jer nema druge površine kojoj bi bio drugi.
Dokumentovano i isprobano
OpenAPI se generiše na /docs i svaka ruta ima test koji je primer iz dokumentacije. Dokumentacija pisana odvojeno od koda za mesec dana zaostane; dokumentacija koja pokvari build kada je pogrešna — ne.
Prijava
Vaš castomo nalog, preko authorization code toka sa PKCE — isti nalog koji koristite za dash-b i ostatak porodice. Stranica bez sopstvenog servera taj tok izvodi sasvim dobro; upravo za to je i dizajniran. Za rad mašina-međusobno, API ključ vezan za projekat.
- 1Ljudi
/v1/contacts·/lists·/segments·/tags·/imports - 2Садржај
/v1/creatives, sa validacijom, pregledom i renderovanjem po cilju - 3Аутоматизација
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4Емитовање
/v1/campaigns, sa publikom, materijalizacijom, zakazivanjem i slanjem kao odvojenim koracima - 5Događaji sa ulaza
/v1/events— događaji iz Vaše sopstvene aplikacije, kao okidači - 6Isporuka
/sender-identities·/domains·/apps·/webhooks - 7Brojevi
/v1/reports/*, i/track/*na hostu za praćenje
OpenAPI na /docs/mcp na istom procesu
Konvencije
Isti oblik kao i kod svake druge castomo usluge
Što je važnije nego što zvuči. Ako već pozivate jednu od ovih usluga, već znate kako ova odgovara, omane i paginira.
Jedan omot za greške
Svaka greška ima isti oblik, stabilan kod i poruku namenjenu čoveku. Nijedna ruta ne izmišlja svoj način nezadovoljstva.
Paginacija kursorom
Ne ofsetima. Lista koja se menja dok je prolazite ne preskače i ne ponavlja redove tiho, što ofset paginacija čini stalno i neprimetno.
Ključevi idempotencije
Na svakoj ruti koja menja stanje. Ponovite zahtev za koji niste sigurni da je stigao i dobićete isti odgovor, a ne drugi kontakt, drugu kampanju ili drugo slanje.
Ograničeno na projekat
Token adresira jednog zakupca i jedan projekat, oboje. Bezbednost na nivou redova sprovodi se u samoj bazi podataka, a ne time što se ne zaboravi dodati jedna klauzula.
Одлазећи вебхукови
Потписани, поново покушани са растућим паузама и испоручени најмање једном — тако да ваш крајњи пункт такође треба да буде идемпотентан. Догађаји користе исти речник који користе и извештаји.
Брисање и извоз
Контакт може бити извезен или обрисан преко API-ја, а брисање стиже до сваког сродног сервиса који држи копију, преко породичног интерног канала.
Све што интерфејс може да уради, POST може да уради.
Догађаји су занимљиви део
Све остало на овој страници је инсталација коју бисте и очекивали. POST /v1/events је рута која мења намену производа.
Ваша апликација већ зна ствари које ниједан маркетиншки алат не може да посматра: ко је завршио укључење, ко је позвао колегу, ко је ударио у лимит, ко је извезао своје податке у недељу поподне. Пошаљите их као догађаје са својим токеном, и сваки од њих постаје окидач, услов и сегмент.
Остало следи из модела контакта. Догађаји се додају, никада не уређују; то је дневник на ком се цели производ ослања. Левак који се активира на догађај који сте сами дефинисали није интеграција — то је исти механизам који користи message_opened, само са другим називом унутра.
- 1Ви га шаљете
POST /v1/events— назив, контакт, садржај, кључ идемпотентности. - 2Стиже на местоДодаје се у дневник контакта. Ником другом није потребно да зна да постоји.
- 3Левак почињеСваки левак чији улаз наводи тај догађај, за сваки контакт који испуњава услове улаза.
- 4Други левкови се гранају на њега„Да ли се овај догађај десио у последњих 14 дана“ је обичан предикат сегмента.
- иИ завршава токовеЧвор циља који наводи исти догађај зауставља секвенцу у тренутку када особа уради ствар.
Ваш речникВаш токен
Границе вредне пажње пре него што почнете да градите
ClickSomo чува три идентификатора о вама — станара, пројекат и корисника, као непрозорне id вредности — и ништа друго. Ни лозинку, ни профил, ни картицу, ни фактуру. Ограничења плана стижу као бројеви: колико контаката, колико слања, колико генерисања. Речник плаћања не прелази ту линију ни у једном смеру.
Ваши контакти су ваши. Ви сте управљач података; ми смо обрађивач. Не постоји пут којим други производ из породице може да чита или пише ваш списак контаката, нити канал за унос који би он могао да користи.
Ако ово озбиљно процењујете: прочитајте /docs пре него што прочитате још било шта на овом сајту. API је поштено описивање онога што производ ради, и свака тврдња на овим страницама одговара рути или врсти чвора коју тамо можете пронаћи. Када се шема промени, ове странице се мењају.