API
કોઈ ખાનગી એન્ડપોઇન્ટ નથી. ઇન્ટરફેસ માટે પણ નહીં.
મોટા ભાગના પ્રોડક્ટ્સમાં બે API હોય છે: ડોક્યુમેન્ટ થયેલી, જે તમને ઓફર કરવામાં આવે છે, અને રસપ્રદ એક, જે તેમના પોતાના સ્ક્રીન્સ વાપરે છે. બીજી હંમેશાં વધુ સારી હોય છે, અને તમને તેની નજીક પણ જવાની પરવાનગી નથી. અહીં એક જ છે, અને ઇન્ટરફેસ તેનો બીજા કોઈની જેમ જ ક્લાયન્ટ છે — જે અમારા માટે એક બંધન છે, અને તમે બનાવવા માંગતા બધું શક્ય બને તેનું કારણ છે.
આ નિયમ ખરેખર શું ખર્ચે છે
તેનો અર્થ એ કે સ્ક્રીનને ક્યારેક API સાચું થાય તેની રાહ જોવી પડે, એક અનુકૂળ ફીલ્ડ માટે તેને બાયપાસ કરવાને બદલે. જે દિવસે સ્ક્રીનને એવું કંઈ જોઈએ જે જાહેર API આપી ન શકે, તે દિવસે API ખોટી છે, અને સુધારો API માં જ છે.
તેનું લાભ એ છે કે ત્રણ સંપૂર્ણ અલગ ક્લાયન્ટ્સનો લગભગ કોઈ વધારાનો ખર્ચ થતો નથી. MCP સર્વર એક ક્લાયન્ટ છે. dash-b ની ટાઇલ એક ક્લાયન્ટ છે. તમારી પોતાની સ્ક્રિપ્ટ એક ક્લાયન્ટ છે. કોઈપણ બીજા વર્ગના નાગરિક નથી જે કોઈક બીજા માટે ડિઝાઇન થયેલી સપાટીને બાયપાસ કરે, કારણ કે બીજી કોઈ સપાટી જ નથી.
ડોક્યુમેન્ટ થયેલી, અને ચકાસાયેલી
OpenAPI /docs પર જનરેટ થાય છે અને દરેક રૂટનો એક ટેસ્ટ છે જે ડોક્યુમેન્ટેશનમાંનું ઉદાહરણ છે. કોડથી અલગ લખાયેલી ડોક્યુમેન્ટેશન એક મહિનામાં જૂની થઈ જાય છે; ખોટી હોય ત્યારે બિલ્ડ નિષ્ફળ કરાવે તેવી ડોક્યુમેન્ટેશન નહીં.
સાઇન ઇન કરવું
તમારું castomo એકાઉન્ટ, PKCE સાથે authorization code flow પર — dash-b અને પરિવારના બાકીના ભાગો માટે વાપરો તે જ એકાઉન્ટ. પોતાનો સર્વર ન ધરાવતું પેજ પણ આ ફ્લો સારી રીતે ચલાવી શકે છે; આ ફ્લો એ જ માટે ડિઝાઇન થયો છે. મશીન-થી-મશીન કામ માટે, પ્રોજેક્ટ-સ્કોપ્ડ API કી.
- 1લોકો
/v1/contacts·/lists·/segments·/tags·/imports - 2સામગ્રી
/v1/creatives, દરેક ટાર્ગેટ માટે વેલિડેશન, પ્રિવ્યૂ અને રેન્ડર સાથે - 3ઑટોમેશન
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4બ્રોડકાસ્ટ
/v1/campaigns, ઓડિયન્સ, મટેરિયલાઇઝ, શિડ્યૂલ અને મોકલવાનાં અલગ પગલાં સાથે - 5ઇવેન્ટ્સ આવે છે
/v1/events— તમારી પોતાની એપ્લિકેશનની ઇવેન્ટ્સ, ટ્રિગર તરીકે - 6ડિલિવરી
/sender-identities·/domains·/apps·/webhooks - 7આંકડા
/v1/reports/*, અને ટ્રેકિંગ હોસ્ટ પર/track/*
/docs પર OpenAPIએ જ પ્રોસેસ પર /mcp
પરિમાણો
બાકીની દરેક castomo સેવા જેવો જ આકાર
જે સાંભળવા કરતાં વધુ મહત્વનું છે. જો તમે પહેલેથી આમાંથી એકને કૉલ કરતા હો, તો તમે પહેલેથી જાણો છો કે આ એક કેવી રીતે જવાબ આપે છે, નિષ્ફળ જાય છે અને પેજિનેટ કરે છે.
એક જ એરર એન્વેલપ
દરેક નિષ્ફળતાનો એક જ આકાર હોય છે, સ્થિર કોડ અને માણસ માટે રચાયેલો સંદેશ. કોઈ રૂટ પોતાની રીતે અસંતોષ વ્યક્ત કરતું નથી.
કર્સર પેજિનેશન
ઓફસેટ નહીં. તમે તેમાં ચાલતા હો ત્યારે બદલાતી લિસ્ટ ચૂપચાપ પંક્તિઓ છોડતી કે પુનરાવર્તિત કરતી નથી, જે ઓફસેટ પેજિનેશન શાંતિથી અને સતત કરે છે.
ઇડેમ્પોટન્સી કીઝ
દરેક ફેરફાર કરતી રૂટ પર. જે વિનંતી પહોંચી કે નહીં તે ખાતરી ન હોય તો તેને ફરી મોકલો અને બીજો સંપર્ક, બીજી ઝુંબેશ કે બીજું મોકલવાનું નહીં — એક જ જવાબ મળશે.
પ્રોજેક્ટ પ્રમાણે મર્યાદિત
એક ટોકન એક ટેનન્ટ અને એક પ્રોજેક્ટ — બંનેને સંબોધે છે. પંક્તિ-સ્તરની સુરક્ષા ડેટાબેઝમાં જ લાગુ થાય છે, કોઈ કલમ ઉમેરવાનું યાદ રાખવાના બદલે.
આઉટગોઇંગ વેબહુક્સ
સહી કરેલા, બેકઓફ સાથે ફરી પ્રયાસ થયેલા અને ઓછામાં ઓછી એક વાર પહોંચાડવામાં આવેલા — તેથી તમારો એન્ડપોઇન્ટ પણ આઇડેમ્પોટન્ટ હોવો જોઇએ. ઇવેન્ટ્સની ભાષા એ જ છે જે રિપોર્ટ્સ વાપરે છે.
ભૂંસવું અને નિકાસ
કોઈ સંપર્ક API મારફતે નિકાસ કે ભૂંસી શકાય છે, અને ભૂંસવાની ક્રિયા પરિવારના પોતાના આંતરિક માર્ગ દ્વારા નકલ ધરાવતી દરેક સહોદર સેવા સુધી પહોંચે છે.
ઇન્ટરફેસ જે કંઈ કરી શકે, એ બધું એક POST કરી શકે છે.
ઇવેન્ટ્સ જ રસપ્રદ ભાગ છે
આ પેજ પરનું બાકી બધું તમે અપેક્ષા રાખો એવું પ્લમ્બિંગ છે. POST /v1/events એ જ રૂટ છે જે આ પ્રોડક્ટ શેના માટે છે તે બદલી નાખે છે.
તમારી એપ્લિકેશન એવી ઘણી બધી વાતો પહેલેથી જાણે છે જે કોઈ માર્કેટિંગ ટૂલ જોઇ શકતું નથી: કોણે ઓનબોર્ડિંગ પૂરું કર્યું, કોણે સાથીદારને આમંત્રણ આપ્યું, કોણે મર્યાદાને અથડાવી, કોણે રવિવાર બપોરે પોતાનો ડેટા નિકાસ કર્યો. તેમને તમારા પોતાના ટોકન સાથે ઇવેન્ટ તરીકે પોસ્ટ કરો, અને દરેક એક ટ્રિગર, એક શરત અને એક સેગમેન્ટ બની જાય છે.
બાકીનું બધું સંપર્ક-મોડેલમાંથી આવે છે. ઇવેન્ટ્સ ઉમેરવામાં આવે છે, ક્યારેય સંપાદિત નહીં; તે એ લોગ છે જેના પર આખી પ્રોડક્ટ ટકેલી છે. તમે વ્યાખ્યાયિત કરેલી ઇવેન્ટ પર ટ્રિગર થતું ફનલ કોઈ ઇન્ટિગ્રેશન નથી — તે એ જ પદ્ધતિ છે જે message_opened વાપરે છે, ફક્ત તેમાં નામ જુદું છે.
- 1તમે તે પોસ્ટ કરો છો
POST /v1/events— એક નામ, એક સંપર્ક, એક પેલોડ, એક આઇડેમ્પોટન્સી કી. - 2તે પહોંચી જાય છેસંપર્કના લોગમાં ઉમેરાય છે. તેનું અસ્તિત્વ જાણવાની બીજા કોઈની જરૂર નથી.
- 3ફનલ શરૂ થાય છેજે ફનલના પ્રવેશમાં એ ઇવેન્ટનું નામ હોય, તે દરેક ફનલ — તેના પ્રવેશ નિયમ હેઠળ પાત્ર દરેક સંપર્ક માટે.
- 4બીજી ફનલ્સ તેના પર શાખા પાડે છે"આ ઇવેન્ટ છેલ્લા 14 દિવસમાં થઈ છે કે નહીં" એ એક સામાન્ય સેગમેન્ટ શરત છે.
- iઅને તે રન્સ પૂરી કરે છેએ જ ઇવેન્ટનું નામ ધરાવતો ગોલ નોડ વ્યક્તિ એ કામ કરતાની ક્ષણે સિક્વન્સ રોકી દે છે.
તમારી ભાષાતમારું ટોકન
બિલ્ડ કરતા પહેલાં જાણવા લાયક મર્યાદાઓ
ClickSomo તમારા વિશે ત્રણ ઓળખકર્તા સંગ્રહે છે — એક ટેનન્ટ, એક પ્રોજેક્ટ અને એક યુઝર, અપારદર્શક ids તરીકે — અને બીજું કંઈ નહીં. કોઈ પાસવર્ડ નહીં, કોઈ પ્રોફાઇલ નહીં, કોઈ કાર્ડ નહીં, કોઈ ઇનવોઇસ નહીં. પ્લાનની મર્યાદાઓ આંકડા તરીકે આવે છે: કેટલા સંપર્કો, કેટલા મેસેજ, કેટલી જનરેશન્સ. ચુકવણીની ભાષા એ લીટીને કોઈ બાજુથી પાર નથી થતી.
તમારા સંપર્કો તમારા છે. તમે ડેટા કંટ્રોલર છો; અમે પ્રોસેસર છીએ. પરિવારની બીજી કોઈ પ્રોડક્ટ તમારી સંપર્ક-યાદી વાંચી કે લખી શકે એવો કોઈ માર્ગ નથી, અને તેને વાપરવા માટે કોઈ ઇન્જેસ્ટ લેન પણ નથી.
જો તમે આનું ગંભીરતાથી મૂલ્યાંકન કરી રહ્યા હો: આ વેબસાઇટનું વધુ કંઈ વાંચતા પહેલાં /docs વાંચો. API એ આ પ્રોડક્ટ શું કરે છે તેનું પ્રામાણિક વર્ણન છે, અને આ પેજો પરનો દરેક દાવો ત્યાં મળી શકે એવા કોઈ રૂટ કે નોડ કાઇન્ડ સાથે મેળ ખાય છે. સ્કીમા બદલાય ત્યારે આ પેજો પણ બદલાય છે.