API
Niy ma prywatnego endpointu. Niy ma nawet dlŏ interfejsu.
Wiynkszość produktōw ma dwa API: udokumentowane, kere ci dajōm, i ciekawsze, kerego używajōm ich włosze ekrany. Drugi je zawsze lepszy, a ty niy mosz do niego dostympu. Tukej je jeden, a interfejs je jego klientym jak wszystko inksze — to je ograniczynie dlŏ nas i prziczyna, dlaczego wszystko, co chcesz zbudować, je możliwe.
Co ta reguła naprawde kosztuje
Znaczy to, że ekran czasami musi poczekać, ażeby API było dobre, zamiast ôbjeść je i wziōńć jedno wygodne pole. Dziyń, jak ekran potrzebuje czegoś, czego publiczne API dać niy mo, to dziyń, jak API je złe, a naprawa to API.
Zysk je taki, że trziy barzo różne klienty niy kosztujōm prawie nic ekstra. Serwer MCP je klientym. Kafel dash-b je klientym. Twōj włŏsny skrypt je klientym. Żodny z nich niy je obywatelem drugij kategoryje ôbchodzōncym powierzchniã zaprojektowanõ dlŏ kogoś inkszego, bo niy ma inkszyj powierzchni, ô ktorã można być drugim.
Udokumentowane i używane
OpenAPI je generowane na /docs, a kożdo trasa ma test, kery je przikładym we dokumentacyji. Dokumentacyjo pisano ôsobno ôd kodu rozłazi sie w mōncz; dokumentacyjo, kera wywala build, jak je zło, — niy.
Logowanie
Twoje konto castomo, przez flow autoryzacyjnygo kodu z PKCE — to samo konto, kere używŏsz do dash-b i reszty familije. Strona bez włŏsnego serwera robi ten flow bez problemu; do tego go zaprojektowano. Do roboty maszyna-maszyna: klucz API ôbszarowy na projekt.
- 1Ludzie
/v1/contacts·/lists·/segments·/tags·/imports - 2Zawartość
/v1/creatives, z walidacyjōm, podglōndym i renderowaniym na kożdy cel - 3Autōmatyzacyjŏ
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4Transmisyjŏ
/v1/campaigns, z audytorium, materializacyjōm, planowaniym i wysyłkōm jako ôsobne kroki - 5Zdarzenia wejściowe
/v1/events— zdarzenia twojij włŏsnyj aplikacyje, jako triggery - 6Dostawa
/sender-identities·/domains·/apps·/webhooks - 7Nōmbry
/v1/reports/*, a/track/*na hoście śledzynia
OpenAPI na /docs/mcp na tym samym procesie
Kōnwencyje
Ten sam kształt jak kożdo inkszo usługa castomo
To znaczy wiyncyj, jak sie brzmi. Jak już wywołujesz jedną z nich, to już wiesz, jak ta ôdpowio, przepado i strōnuje.
Jedno opakowanie błydōw
Kożde niepowodzynie ma ten sam kształt, stabilny kod i wiadomość dlŏ człowieka. Żodno trasa niy wymyślo włŏsnego sposobu bycia niezadowolōnõ.
Paginacyjo kursorem
Niy ôffsety. Lista, kera sie zmiynio, jak jã idziesz, niy przeskakuje ani niy powtorzo wierszōw po cichu — co paginacyjo ôffsetowŏ robi cicho i ciōngiym.
Klucze idempotencyje
Na kożdej trasie zmiyniajōncyj. Powtōrz prośbã, co niy wiysz, czy doszła, i dostaniesz tã samõ ôdpowiedź, a nie drugi kontakt, drugõ kampanijã abo drugõ wysyłkã.
Ôbszarowo na projekt
Token adresuje jednego tenanta i jeden projekt, ôba. Bezpieczeństwo na poziomie wierszy je wymuszane we samyj bazie danych, a niy pamiyntaniym, ażeby dodać klauzulã.
Webhōki wychodzōnce
Podpisane, powtarzane z backoffem i dostawiane co najmniej roz — tak że twōj endpoint tyż powinien być idempotentny. Zdarzenia sōm tym samym słownictwym, kere używajōm raporty.
Wymazanie i eksport
Kontakt można wyeksportować abo wymazać przez API, a wymazanie dochodzi do kożdej siostrzanyj usługi, kera mioła kopjã, przez włŏsny wewnętrzny korytarz familije.
Wszystko, co umi interfejs, umi tyż POST.
Zdarzynia sōm tym ciekawym
Wszystko inksze na tyj strōnie to instalacyjne rury, kerych sie spodziewosz. POST /v1/events to trasa, co zmiynio, na co je tyj produkt.
Twoja aplikacyjōn już wie rzeczy, kerych żodny marketingowy noczynie niy widzi: kōńczył onboardōng, kto zaprosił kolegę, kto trzefoł we limit, kto wyeksportowoł swoje dane we niedziela popołniu. Poślij to jako zdarzynia ze swojim tokenym, a kożde stōnie sie wyzwaloczym, warunkym i segmentym.
Inksze wynikŏ z modelu kōntaktu. Zdarzynia sōm dodowane, nigdy niy edytowane; to log, na kerym wiszy cały produkt. Lejek, co wyzwalŏ sie na zdarzyniu, kere sam zdefiniowoł, to niy integracyjŏ — to sam mechanizm, kery używo message_opened, ino z inkszym mianym w strzodku.
- 1Ty to poślijesz
POST /v1/events— miano, kōntakt, payload, klucz idempotencyjny. - 2To przidzieDodane do logu kōntaktu. Nikt inkszy niy musi wiedzieć, że istniyje.
- 3Lejek startujeKażdy lejek, kerego wejściy wymiyńo to zdarzynie, dlŏ kożdego kōntaktu, co pasuje pod jego specyfikacyjŏ wejściŏ.
- 4Inksze lejki sie na nim rozgałyniajōm„Czy to zdarzynie bōło we ôstatnich 14 dniach” to zwykły predykat segmentu.
- aA tyż kōńczy przebiegiWęzeł celu wymiyńajōncy to same zdarzynie zatrzymuje sekwyncyjōm w tyj chwili, kej czowiek zrobi te rzecz.
Twoje słownictwoTwōj token
Granice, warte wiedzynia, zanim zaczniesz budować
ClickSomo trzimŏ trzy identyfikatory ô tobie — tenant, projekt i użytkownika, jako nieprzejrzyste idy — i nic wiyncyj. Żodnego hasła, żodnego profilu, żodnyj karty, żodnyj faktury. Limity planu przidajōm jako liczby: ile kōntaktōw, ile wysyłek, ile generacyji. Słownictwo płatności niy przekrŏcojŏ tyj granice w żodnōm kierunku.
Twoje kōntakty sōm twoje. Ty jesteś administratōrym danych; my jesteśmy procesorym. Niy ma trasy, kerym inny produkt z familije mōgłby czytać abo zapisować twojõ listã kōntaktōw, i niy ma ścieżki ingestu dlŏ niego.
Jeśli ty serio to szacujesz: przeczytej /docs, zanim przeczytej cokolwiek wiyncyj na tyj strōnie. API to uczciwy ôpis tego, co robi produkt, i kożde twierdzynie na tych strōnach mapuje sie na trasã abo rodzaj węzła, kere tam znajdziesz. Kiedy schema sie zmiynio, te strōny sie zmiyniajōm.