clickSomo

API

Ne postoji privatni endpoint. Čak ni za sučelje.

Većina proizvoda ima dva API-ja: dokumentirani koji vam nude, i zanimljivi koji koriste njihovi vlastiti ekrani. Drugi je uvijek bolji, i nikad vam nije dopušteno do njega. Ovdje postoji jedan, a sučelje je njegov klijent kao i sve ostalo — što je ograničenje za nas, i razlog zašto je sve što želite izgraditi moguće.

Šta to pravilo zaista košta

Znači da ekran ponekad mora čekati da API bude ispravan, umjesto da zaobiđe njega za jedno zgodno polje. Dan kada ekran treba nešto što javni API ne može dati, to je dan kada je API pogrešan, i rješenje je API.

Prednost je da tri vrlo različita klijenta gotovo ništa ne koštaju dodatno. MCP server je klijent. dash-b pločica je klijent. Vaša vlastita skripta je klijent. Nijedan od njih nije građanin drugog reda koji zaobilazi površinu dizajniranu za nekog drugog, jer nema druge površine kojoj bi bio drugi.

Dokumentirano i isprobano

OpenAPI se generira na /docs i svaka ruta ima test koji je primjer iz dokumentacije. Dokumentacija pisana odvojeno od koda za mjesec dana zaostane; dokumentacija koja obara build kad je pogrešna ne zaostaje.

Prijava

Vaš castomo račun, preko authorization code toka s PKCE — isti račun koji koristite za dash-b i ostatak porodice. Stranica bez vlastitog servera taj tok izvodi sasvim dobro; upravo za to je tok i dizajniran. Za rad stroj-stroju, API ključ opsega projekta.

Površinaapi.clicksomo.com
  • 1Ljudi/v1/contacts · /lists · /segments · /tags · /imports
  • 2Sadržaj/v1/creatives, s validacijom, pregledom i renderiranjem po cilju
  • 3Automatizacija/v1/funnels · /funnels/:id/versions · /runs · /simulate
  • 4Emitovanje/v1/campaigns, s publikom, materijalizacijom, raspoređivanjem i slanjem kao zasebnim koracima
  • 5Događaji ulaze/v1/events — događaji vaše vlastite 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 svaka druga castomo usluga

Što je važnije nego što zvuči. Ako već pozivate jednu od ovih, već znate kako ova odgovara, zakine i paginira.

Jedan omot grešaka

Svaka greška ima isti oblik, stabilan kod i poruku namijenjenu osobi. Nijedna ruta ne izmišlja svoj način nezadovoljstva.

Cursor paginacija

Ne offseti. Lista koja se mijenja dok je prolazite ne preskače i ne ponavlja redove tiho, što offset paginacija čini tiho i stalno.

Ključevi idempotencije

Na svakoj ruti koja mijenja stanje. Ponovite zahtjev za koji niste sigurni da je stigao i dobijte isti odgovor, a ne drugi kontakt, drugu kampanju ili drugo slanje.

Opseg na projekt

Token adresira jednog stanara i jedan projekt, oboje. Sigurnost na nivou redova provodi sama baza podataka, a ne pamćenje da se doda klauzula.

Webhooks prema van

Potpisano, ponovljeno sa odgodom i isporučeno barem jednom — pa vaš endpoint također treba biti idempotentan. Događaji koriste isti rječnik koji koriste izvještaji.

Brisanje i izvoz

Kontakt se može izvesti ili izbrisati putem API-ja, a brisanje doseže svaku sestrinsku uslugu koja je držala kopiju, kroz porodični interni kanal.

Sve što interfejs može, POST može.

Događaji su zanimljivi dio

Sve ostalo na ovoj stranici je infrastruktura koju biste očekivali. POST /v1/events je ruta koja mijenja čemu proizvod služi.

Vaša aplikacija već zna stvari koje nijedan marketinški alat ne može uočiti: ko je završio uvođenje, ko je pozvao kolegu, ko je pogodio ograničenje, ko je izvezao svoje podatke u nedjelju popodne. Pošaljite ih kao događaje svojim tokenom, i svaki postaje okidač, uslov i segment.

Ostalo proizlazi iz modela kontakta. Događaji se dodaju, nikada ne uređuju; to je dnevnik na koji visi cijeli proizvod. Lijevka koja se aktivira na događaj koji ste vi definisali nije integracija — to je isti mehanizam koji koristi message_opened, samo s drugim imenom u njemu.

Vaš događaj postaje lijevkaapi_event
  • 1Vi ga pošaljetePOST /v1/events — ime, kontakt, sadržaj, ključ idempotencije.
  • 2StigneDodaje se u dnevnik kontakta. Nikome drugom ne treba znati da postoji.
  • 3Lijevka počinjeSvaka lijevka čiji ulaz spominje taj događaj, za svaki kontakt koji ispunjava uslove njenog ulaznog pravila.
  • 4Druge lijevke se granaju na njemu"Da li se ovaj događaj desio u posljednjih 14 dana" je običan predikat segmenta.
  • iI završava pokretanjaČvor cilja koji spominje isti događaj zaustavlja sekvencu u trenutku kada osoba uradi tu stvar.

Vaš rječnikVaš token

Granice vrijedne poznavanja prije nego što počnete graditi

ClickSomo čuva tri identifikatora o vama — stanara, projekat i korisnika, kao neprozirne id-jeve — i ništa drugo. Nema lozinke, profila, kartice ni fakture. Ograničenja plana stižu kao brojevi: koliko kontakata, koliko slanja, koliko generisanja. Rječnik plaćanja ne prelazi tu granicu ni u jednom smjeru.

Vaši kontakti su vaši. Vi ste upravljač podacima; mi smo procesor. Ne postoji put kojim drugi proizvod u porodici može čitati ili pisati vašu listu kontakata, ni kanal za unos koji bi jedan koristio.

Ako ovo ozbiljno procjenjujete: pročitajte /docs prije nego što dalje čitate ovu web-stranicu. API je iskren opis onoga što proizvod radi, i svaka tvrdnja na ovim stranicama odgovara ruti ili vrsti čvora koju tamo možete pronaći. Kada se šema promijeni, ove stranice se mijenjaju.