API-a
Ez dago endpoint pribaturik. Interfazerako ere ez.
Produktu gehienek bi API dituzte: eskaintzen zizun dokumentatua, eta beren pantailak erabiltzen duen bitxia. Bigarrena beti da hobea, eta inoiz ez zaizu hurbiltzen uzten. Hemen bat dago, eta interfazea haren bezeroa da beste edozer bezala — guretzako muga bat da, eta zuk eraiki nahi duzun guztia posible izateko arrazoia.
Arau horrek benetan zer kostatzen duen
Esan nahi du pantaila batek batzuetan itxaron behar duela API-a zuzen egon arte, eremu bakar baterako inguratu beharrean. Pantaila batek API publikoak eman ezin duen zerbait behar duen eguna da API-a gaizki dagoen eguna, eta konponketa API-a da.
Irabazia da hiru bezero oso desberdinek ia ezer gehigarririk gabe funtzionatzea. MCP zerbitzaria bezeroa da. Dash-beko lauza bat bezeroa da. Zure script-a bezeroa da. Inor ez da bigarren mailako herritarra beste norbaitentzat diseinatutako azalera baten inguruan lan egiten, ez dagoelako beste azalerarik atzean uzteko.
Dokumentatua, eta probatua
OpenAPI /docs helbidean sortzen da, eta bide bakoitzak proba bat du, dokumentazioko adibidea dena. Kodetik bereizita idazten den dokumentazioa hilabete barru zaharkituta geratzen da; gaizki dagoenean build-a hutsarazten duen dokumentazioak ez.
Saioa hasten
Zure castomo kontua, PKCE duen authorization code fluxuaren bidez — dash-b eta familiako gainerakoentzat erabiltzen duzun kontu bera. Zerbitzaririk ez duen orri batek fluxu hori ongi exekutatzen du; horretarako diseinatu zen fluxua. Makina-makinako lanetarako, proiektuaren araberako API gako bat.
- 1Jendea
/v1/contacts·/lists·/segments·/tags·/imports - 2Edukia
/v1/creatives, balidazioa, aurrebista eta errendatzea helburu bakoitzeko - 3Automatizazioa
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4Igorpena
/v1/campaigns, audientzia, materializatu, programatu eta bidali urrats bereizi gisa - 5Gertaerak sarreran
/v1/events— zure aplikazioko gertaerak, aktibagailu gisa - 6Entrega
/sender-identities·/domains·/apps·/webhooks - 7Zenbakiak
/v1/reports/*, eta/track/*jarraipen-ostalarian
OpenAPI /docs helbidean/mcp prozesu berean
Ohiturak
Castomo zerbitzu guztiek duten forma bera
Badirudena baino garrantzitsuagoa da. Horietako bat deitzen baduzu jada, badakizu nola erantzuten, huts egiten eta orrialdekatzen duen honek.
Errore-azal bakarra
Hutsegite guztiek forma bera dute, kode egonkor bat eta pertsonarentzako mezu bat. Ez dago biderik bere moduan kexatzen denik.
Kursor bidezko orrialdekatzea
Desplazamenduak ez. Zeharkatzen ari zaren bitartean aldatzen den zerrenda batek ez ditu errenkadak isilik saltatzen edo errepikatzen, desplazamendu bidezko orrialdekatzeak isilik eta etengabe egiten duen bezala.
Idempotentzia-gakoak
Aldatzen duen ibilbide guztietan. Lurrera heldu ala ez ziur bazaude, eskaera bat berriro saia zaitezke eta erantzun bera jasoko duzu, bigarren kontaktu bat, bigarren kanpaina edo bigarren bidalketa bat izan beharrean.
Proiektu batera mugatua
Token batek maizter bat eta proiektu bat helbitatzen ditu, biak aldi berean. Errenkada-mailako segurtasuna datu-baseak berak betearazten du, klausula bat gehitzea gogoratzearen mende egon beharrean.
Webhookak kanpora
Sinatuak, atzerapenarekin berritatzen direnak eta behintzat behin entregatzen direnak — beraz, zure endpoint-a ere idempotentea izan behar du. Gertaerak txostenek erabiltzen duten hiztegi bera dute.
Ezabatzea eta esportatzea
Kontaktu bat esportatu edo ezaba daiteke APIaren bidez, eta ezabatzea baten baten kopia zeukan ahizpa-zerbitzu guztietara iristen da familiaren barne-kanalaren bidez.
Interfazeak egin dezakeen guztia, POST batek egin dezake.
Gertaerak dira interesgarriena
Orri honetako gainerako guztia espero zenukeen hodi-lana da. POST /v1/events da produktuak zertarako balio du aldatzen duen ibilbidea.
Zure aplikazioak dagoeneko badaki marketin-tresnarik ikus ez dezakeen gauzarik: nor amaitu du onboarding-a, norrek lankide bat gonbidatu duen, norrek muga bat jo duen, norrek igande arratsalde batean bere datuak esportatu dituen. Bidali horiek gertaera gisa zure tokenarekin, eta bakoitzak abiadura, baldintza eta segmentu bihurtuko dira.
Gainerakoa kontaktu-eredutik sortzen da. Gertaerak eranstera soilik gehitzen dira, inoiz ez editatzeko; produktu osoa zintzilik dagoen erregistroa dira. Zuk definitutako gertaera batean abiatzen den infunnel bat ez da integrazio bat — message_opened erabiltzen duen mekanismo bera da, barruan beste izen batekin.
- 1Zuk bidaltzen duzu
POST /v1/events— izen bat, kontaktu bat, karga bat, idempotentzia-gako bat. - 2Lurrera heltzen daKontaktuaren erregistroari erantsita. Beste ezerk ez du existitzen dela jakin behar.
- 3Infunnel bat hasten daSarreran gertaera hori aipatzen duen edozein infunnel, bere sarrera-espekulupean hautagarria den edozein kontaktorentzat.
- 4Beste infunnelak horretan adartzen dira"Gertaera hau gertatu al da azken 14 egunetan" segmentu-irizpide arrunt bat da.
- iEta exekuzioak amaitzen dituGertaera bera aipatzen duen helburu-nodo batek sekuentzia bat gelditzen du pertsonak gauza hori egiten duen unean bertan.
Zure hiztegiaZure tokena
Eraikin hasi aurretik jakin beharreko mugak
ClickSomo-k hiru identifikatzaile gordetzen dizkizu zuri buruz — maizter bat, proiektu bat eta erabiltzaile bat, id opaku gisa — eta ez ezer gehiago. Ez pasahitzik, ez profilik, ez txartelik, ez fakturarik. Planaren mugak zenbaki gisa iristen dira: kontaktu zenbat, bidalketa zenbat, sorkuntza zenbat. Ordainketaren hiztegia ez da muga hori zeharkatzen ez alde batetik ez bestetik.
Zure kontaktuak zureak dira. Zu zara datuen kontrolatzailea; gu prozesatzailea. Ez dago familiako beste produktu batek zure kontaktu-zerrenda irakur edo idatz dezan inolako ibilbiderik, eta ez dago horretarako sarrerako kanalik.
Hau serio ebaluatzen ari bazara: irakurri /docs webgune honetako orri gehiago irakurri aurretik. APIa da produktuak zer egiten duen deskribapen zintzoa, eta orri hauetako baieztapen bakoitzak han aurki dezakezun ibilbide edo nodo-mota batera mapatzen da. Eschema aldatzen denean, orri hauek aldatu egiten dira.