API
Maxfiy endpoint yo‘q. Hatto interfeys uchun ham yo‘q.
Ko‘p mahsulotlarda ikkita API bor: sizga taklif qilinadigan hujjatlashtirilgan API va ularning o‘z ekranlari ishlatadigan qiziqarli API. Ikkinchisi doim yaxshiroq, va siz unga hech qachon yaqinlashishga ruxsat berilmaydi. Bu yerda bittasi bor va interfeys boshqa hamma narsa kabi uning mijozidir — bu biz uchun cheklov va siz qurmoqchi bo‘lgan hamma narsaning mumkin bo‘lish sababidir.
Bu qoida aslida qancha turadi
Bu ba’zan ekran API to‘g‘ri bo‘lishini kutishi kerakligini anglatadi, bitta qulay maydon uchun uni chetlab o‘tish o‘rniga. Ekran ommaviy API bera olmaydigan narsaga muhtoj bo‘lgan kuni — API noto‘g‘ri bo‘lgan kuni va yechim API dir.
Foydasi shundaki, uchta butunlay turli mijoz deyarli qo‘shimcha xarajatsiz amalga oshadi. MCP server mijoz. Dash-b plitkasi mijoz. Sizning o‘z skriptingiz mijoz. Ulardan hech biri boshqa kimso uchun mo‘ljallangan yuzani chetlab o‘tuvchi ikkinchi darajali fuqaro emas, chunki ikkinchi bo‘lish uchun boshqa yuza yo‘q.
Hujjatlashtirilgan va sinovdan o‘tkazilgan
OpenAPI /docs da generatsiya qilinadi va har bir yo‘l uchun hujjatlardagi misol bo‘lgan test mavjud. Koddan alohida yozilgan hujjatlar bir oy ichida chetlanadi; noto‘g‘ri bo‘lsa buildni buzadigan hujjatlar esa chetlanmaydi.
Tizimga kirish
Sizning castomo hisobingiz, PKCE bilan authorization code flow orqali — dash-b va oilaning qolgan qismida ishlatadigan xuddi shu hisob. O‘z serveriga ega bo‘lmagan sahifa bu oqimni bemalol bajaradi; bu oqim shu maqsadda loyihalangan. Mashinadan-mashinaga ish uchun loyiha doirasidagi API kaliti.
- 1Odamlar
/v1/contacts·/lists·/segments·/tags·/imports - 2Kontent
/v1/creatives, har bir target uchun validatsiya, preview va render bilan - 3Avtomatlashtirish
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4Translatsiya
/v1/campaigns, audience, materialise, schedule va send alohida qadamlar sifatida - 5Kiruvchi hodisalar
/v1/events— sizning o‘z ilovangiz hodisalari, trigger sifatida - 6Yetkazib berish
/sender-identities·/domains·/apps·/webhooks - 7Raqamlar
/v1/reports/*va kuzatuv hostida/track/*
OpenAPI /docs daXuddi shu jarayonda /mcp
Konventsiyalar
Boshqa barcha castomo xizmatlari bilan bir xil shakl
Bu eshitilganidan ko‘proq ahamiyatga ega. Agar siz ulardan birini allaqachon chaqirsangiz, bu biri qanday javob berishini, qanday xato qilishini va qanday sahifalashishini allaqachon bilasiz.
Bitta xato konverti
Har bir xato bir xil shaklga ega, barqaror kod va odamga mo‘ljallangan xabar. Hech bir yo‘l o‘zining norozilik usulini ixtiro qilmaydi.
Kursorli sahifalash
Ofsetlar emas. Siz yurib chiqayotganingizda o‘zgargan ro‘yxat qatorlarni jim o‘tkazib yubormaydi yoki takrorlamaydi — ofsetli sahifalash esa buni jim va doimiy qiladi.
Idempotency kalitlari
Har bir o‘zgartiruvchi yo‘lda. Yetib bormaganiga ishonchingiz komil bo‘lmagan so‘rovni qayta yuboring va ikkinchi kontakt, ikkinchi kampaniya yoki ikkinchi yuborish o‘rniga bir xil javob oling.
Loyihaga doiragan
Token bitta tenant va bitta loyihani, ikkalasini ham manzillaydi. Qator darajasidagi xavfsizlik ma’lumotlar bazasining o‘zida amalga oshiriladi, qo‘shimcha shart qo‘shishni esda saqlash orqali emas.
Tashqi webhooklar
Imzolangan, kechikish bilan qayta uriniladi va kamida bir marta yetkaziladi — shuning uchun endpointingiz ham idempotent bo'lishi kerak. Hodisalar hisobotlarda ishlatiladigan xuddi shu lug'atdir.
O'chirish va eksport
Kontakt API orqali eksport qilinishi yoki o'chirilishi mumkin, va o'chirish oilaning o'z ichki kanali orqali nusxa saqlagan har bir qardosh xizmatga yetib boradi.
Interfeys qila oladigan hamma narsani POST ham qila oladi.
Qiziqarli qism — hodisalar
Bu sahifadagi qolgan hamma narsa kutilgan infratuzilma. POST /v1/events — mahsulotning maqsadini o'zgartiradigan yo'nalish.
Ilovangiz hech bir marketing vositasi kuzatib bo'lmaydigan narsalarni allaqachon biladi: kim onboardingni tugatdi, kim hamkasbni taklif qildi, kim limitga urildi, kim yakshanba kuni tushdan keyin ma'lumotlarini eksport qildi. Ularni o'z tokeningiz bilan hodisa sifatida yuboring — va har biri trigger, shart va segmentga aylanadi.
Qolgani kontakt modelidan kelib chiqadi. Hodisalar qo'shiladi, hech qachon tahrirlanmaydi; ular butun mahsulot tayanadigan jurnaldir. Siz belgilagan hodisaga ishga tushadigan voronka integratsiya emas — bu message_opened ishlatadigan xuddi shu mexanizm, faqat boshqa nom bilan.
- 1Siz uni yuborasiz
POST /v1/events— nom, kontakt, payload va idempotentlik kaliti. - 2U yetib keladiKontaktning jurnaliga qo'shiladi. Uning mavjudligini boshqa hech kim bilishi shart emas.
- 3Voronka ishga tushadiKirish qismida o'sha hodisa ko'rsatilgan har qanday voronka — kirish shartiga mos har qanday kontakt uchun.
- 4Boshqa voronkalar undan shoxlanadi«Bu hodisa oxirgi 14 kun ichida sodir bo'lganmi» — oddiy segment sharti.
- iVa u yuritishlarni tugatadiXuddi shu hodisani ko'rsatuvchi maqsad tuguni odam o'sha ishni qilgan zahoti ketma-ketlikni to'xtatadi.
Sizning lug'atingizSizning tokeningiz
Qurishdan oldin bilib olishga arziydigan chegaralar
ClickSomo siz haqingizda uchta identifikatorni saqlaydi — tenant, loyiha va foydalanuvchi, shaffof bo'lmagan id sifatida — va boshqa hech narsani saqlamaydi. Parol yo'q, profil yo'q, karta yo'q, hisob-faktura yo'q. Tarif chegaralari raqamlar sifatida keladi: qancha kontakt, qancha yuborish, qancha generatsiya. To'lov lug'ati bu chegaradan hech qaysi tomonga o'tmaydi.
Kontaktingiz sizniki. Ma'lumotlar boshqaruvchisi — siz; ishlov beruvchi — biz. Oiladagi boshqa mahsulot sizning kontakt ro'yxatingizni o'qiy yoki yozadigan yo'nalish yo'q, va birortasi foydalanadigan yutish kanali ham yo'q.
Agar buni jiddiy baholayotgan bo'lsangiz: bu saytning qolgan qismini o'qishdan oldin /docs sahifasini o'qing. API — mahsulot nima qilishining halol tavsifi, va bu sahifalardagi har bir da'vo u yerda topishingiz mumkin bo'lgan yo'nalish yoki tugun turiga mos keladi. Sxema o'zgarganda, bu sahifalar ham o'zgaradi.