API
Ni ma privatnégò endpointu. Nawet dlô interfejsu.
Wielë produktów mòją dwa API: òpisóné, chtërné cë òferëją, i cekôwé, chtërnégò ùżiwają ich wlasné ekranë. Drëdżi je zawszé lepszi, a cë nigdë nie mòżesz do niegò bliskò. Tu je jeden, i interfejs je jegò klientã jak wszëtkò jinégò — co je ògraniczenim dlô nas, i przëczëną, czémù wszëtkò, czegò chcesz zbudowac, je mòżlëwé.
Czégò naprawdã kòsztuje ta reguła
Òznôczô to, że ekran czasem mùszi czekac, aż API bãdze pòprawné, zamiast òbjachac gò dlô jednégò wëgodnégò pòla. Dzéń, w chtërnym ekran potrzebuje czegò, czegò pùbliczné API nie mòże dac, to dzéń, w chtërnym API je złé, i nôprôwã je API.
Zysk je w tim, że trzë bardzo rozné klientë kòsztują prawie nic wicy. Serwer MCP je klient. Kafel na dashbòrdze je klient. Twòj wlasny skript je klient. Żaden z nich nie je òbwatélã drëdżi kategorii, chtërny òbjachô pòwierzchniã kònstruowóną dlô czegòs jinégò, bo ni ma jinégò pòwierzchniô, do chtërnégò mògłibë bëc drëdżim.
Òpisóné i wëkòrëstowóné
OpenAPI je generowóné na /docs i każda routa mòjô test, chtërny je przëkładã w dokùmentacëji. Dokùmentacëjô pisóna òsobno òd kòdu rozchôdzy sã z nim w mąsącu; dokùmentacëjô, chtërna fôlëje bùdinkòwi, jak je złô, nie.
Logòwanié sã
Twòjé konto castomo, przez przepłew autorizacjowégò kòdu z PKCE — to samé kònto, chtërnégò ùżiwôsz do dash-b i zôstnëch z familëji. Strona bez swòjégò serwera mòże ten przepłew wëkònac doskonale; na to òn òstôł ùsôdzony. Do robòtë maszina-do-maszinë: klucz API òbczasu projéktu.
- 1Lëdze
/v1/contacts·/lists·/segments·/tags·/imports - 2Zamkłosc
/v1/creatives, z walidacją, pòdzérkã i renderowanim dlô kôżdégò célu - 3Aùtomatizacjô
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4Nôdôwanié
/v1/campaigns, z publiką, materializacją, planowaniém i wësłanim jakno òddzelné krokë - 5Zdarzenia wchôdzącé
/v1/events— zdarzenia twòjégò wôsnegò aplikacjów, jakno wëzwalacze - 6Dorëczanié
/sender-identities·/domains·/apps·/webhooks - 7Liczby
/v1/reports/*, a/track/*na serwerze śledzeniô
OpenAPI na /docs/mcp na tim samym procesie
Kònwencje
Ten sam ksztôł jak w kôżdym jinym serwisie castomo
Co je wôżniészé, jak sã wëdôwô. Jeżlë ju wëwòłiwôsz jeden z nich, ju wiesz, jak ten òdpôwiôdô, jak félëje i jak paginëje.
Jeden kònwert félów
Kôżdi fél mô ten sam ksztôł, stabilny kòd i wiadłëznã miérzóną dlô człowieka. Żôdnô droga nie wëmëszlô swòjégò sposobu bëc nieszczãsną.
Paginacjô kursorowô
Nie òdsadzë. Lësta, chtërna sã zmieniwô, gdë pò ni chôdzisz, nie przeskôkùje ani nie pòwtôrzô wiérzów cëchò, co paginacjô òdsadzë robi cëchò i ciągło.
Klucze idempotencje
Na kôżdi drodze, chtërna cë zmieniwô. Pòwtôrz żądanié, chtërnégò nie jes pewny, że doszło, i dostóniesz tã samą òdpòwiesc zamiast drëdżégò kòntaktu, drëdżi kampanie abò drëdżégò wësłaniô.
Òbczasu projéktu
Token adresëje jeden tenant i jeden projékt, òba. Bezpieczeństwo na równi wiérzów je wëkònóné w sami bazie dónëch, nie przez pòmôcenié dodaniô klauzule.
Webhooks wëchôdzącé
Pòdpisóné, pòwtórzoné z backoffã, i dorëczóné przë nômni rôz — tak że twòj endpoint téż mùszi bëc idempotentny. Zdarzenia mają ten sam słowôrz, chtërnégò ùżiwają rapòrtë.
Wëmazanié i eksport
Kòntakt mòże bëc eksportowóny abò wëmazóny przez API, a wëmazanié doszô do kôżdégò bratnégò serwisu, chtërnë trzëmôł kòpiã, przez wôsną wewnątrzną lanã familëji.
Wszëtkò, co mòże interfejs, mòże zrobic POST.
Zdarzenia są tim cëkôwim dzélã
Wszëtkò jinégò na ti stronie je instalacjô, chtërnégò sã spòdzôwô. POST /v1/events je droga, chtërna zmieniwô, na co ten produkt je.
Twòjô aplikacjô ju wie rzeczy, chtërnëch żôdné marketingòwé nôrzãdze nie mòże òbaczëc: chto skùńczëł onboarding, chto pòzwał kòlegã, chto trôfił na granicã, chto eksportowôł swòje dóné w niedzelny pòpòłniu. Pòsëj je jakno zdarzenia z twòjim tokenã, a kôżdé z nich stôwô sã wëzwalaczã, warunkã i segmentã.
Zôstatny pòchôdô z modelu kòntaktu. Zdarzenia sã dôwóné, nigdë nie redagowóné; to je log, na chtërnym wisi całi produkt. Lejek wëzwalóny na zdarzenim, chtërné sam zdefiniowôł, nie je integracjô — to je ten sam mechanizm, chtërnégò ùżiwô message_opened, z jinym mionã w nim.
- 1Të to pòsëlôsz
POST /v1/events— miono, kòntakt, payload, klucz idempotencje. - 2Ono doszôDôwóné do loga kòntaktu. Nic jinégò nie mùszi wiedzec, że ònò òstôło.
- 3Lejek zaczinô sãKażdi lejek, chtërnégò wstëp mieniuje tamten event, dlô kòżdégò kòntaktu, chtërny je przëjimny wedle jegò wstëpnégò specifikacjë.
- 4Inne leje rozgałezëwają sã na nim"Czë ten event stôł sã w òstatnëch 14 dniach" je zwëkòwim predikatã segmentu.
- iA kùńczi biegiWzél celowé nazwanié tegò samegò eventa stôpô sériã w tim momentu, czedë òsobô zrobi tã rzecz.
Twòjô słowiznaTwòj token
Grëcë, wôrt znac przed tim, jak sã pòbùdëjesz
ClickSomo trzëmô trzë identifikatorë ò tobie — tenant, projekt ë brëkòwnika, jakò nieprzezérné id — ë nic wicy. Żadnégò parola, żadnégò profilu, żadny karta, żadnégò fakturë. Granicë planu przechòdzą jak numerë: wiélé kòntaktów, wiélé wësélënków, wiélé generacjów. Słowizna płatnoscë nie przekradô ti linie w żôdną stronã.
Twòje kòntaktë są twòje. Ti jes kontrolerã datów; më jeszme òbrôbczim. Ni ma żôdny drôdżi, przez chtërną jin product z familijë mògłbë czëtac abò pisac twòjë lëstã kòntaktów, ë ni ma żôdnégò kanału wchòdzeniô dlô niegò.
Jeżlë ti serio to wëceniôsz: przëczëtôj /docs, zanimlë przëczëtôsz czegòs wicy z ti stronë. API je szczerim òpisankã tegò, co product robi, ë kòżdé twierdzenié na tim stronach mapëje sã na drôdżi abò rodzaj wãzła, chtërné mòżesz tam znalezc. Czedë schema sã zmieniwô, te stronë sã zmieniwają.