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ଅନ୍ୟ ଫନେଲଗୁଡ଼ିକ ଏହା ଉପରେ ଶାଖା ବିସ୍ତାର କରନ୍ତି"ଏହି ଘଟଣା ଶେଷ ୧୪ ଦିନରେ ଘଟିଛି କି" ଏକ ସାଧାରଣ ବିଭାଗ ଶର୍ତ ଅଟେ।
- iଏବଂ ଏହା ଚାଲଣାଗୁଡ଼ିକୁ ଶେଷ କରେସମାନ ଘଟଣାର ନାମ ନେଥିବା ଏକ ଲକ୍ଷ୍ୟ ନୋଡ୍ ବ୍ୟକ୍ତି ଯିବା ମାତ୍ରେ ସେହି କାର୍ଯ୍ୟ କରିବା ମୁହୂର୍ତ୍ତରେ ଏକ କ୍ରମକୁ ବନ୍ଦ କରିଦିଏ।
ଆପଣଙ୍କ ଶବ୍ଦାବଳୀଆପଣଙ୍କ ଟୋକେନ
ନିର୍ମାଣ କରିବା ପୂର୍ବରୁ ଜାଣିବା ଯୋଗ୍ୟ ସୀମାଗୁଡ଼ିକ
ClickSomo ଆପଣ ବିଷୟରେ ତିନୋଟି ପରିଚୟ ସଂରକ୍ଷଣ କରେ — ଏକ ଟେନାଣ୍ଟ, ଏକ ପ୍ରକଳ୍ପ ଏବଂ ଏକ ଉପଭୋକ୍ତା, ଅପାକ ଆଇଡି ଭାବରେ — ଏବଂ ଆଉ କିଛି ନୁହେଁ। କୌଣସି ପାସୱାର୍ଡ, ପ୍ରୋଫାଇଲ୍, କାର୍ଡ କିମ୍ବା ଇନଭଏସ୍ ନାହିଁ। ଯୋଜନାର ସୀମାଗୁଡ଼ିକ ସଂଖ୍ୟା ଭାବରେ ଆସେ: କେତେ ଯୋଗାଯୋଗ, କେତେ ପ୍ରେରଣ, କେତେ ପ୍ରଜନନ। ମୂଲ୍ୟପରିଶୋଧ ଶବ୍ଦାବଳୀ ଉଭୟ ଦିଗରେ ସେହି ସୀମା ଅତିକ୍ରମ କରେ ନାହିଁ।
ଆପଣଙ୍କ ଯୋଗାଯୋଗଗୁଡ଼ିକ ଆପଣଙ୍କର। ଆପଣ ତଥ୍ୟ ନିୟନ୍ତ୍ରକ; ଆମେ ପ୍ରକ୍ରିୟାକାର। ପରିବାରର ଅନ୍ୟ କୌଣସି ଉତ୍ପାଦ ଆପଣଙ୍କ ଯୋଗାଯୋଗ ତାଲିକା ପଢ଼ିବା କିମ୍ବା ଲେଖିବା ପାଇଁ କୌଣସି ମାର୍ଗ ନାହିଁ, ଏବଂ ତାହା ପାଇଁ କୌଣସି ଇନଗେଷ୍ଟ ମାର୍ଗ ନାହିଁ।
ଯଦି ଆପଣ ଏହାକୁ ଗମ୍ଭୀରତାର ସହ ମୂଲ୍ୟାଙ୍କନ କରୁଛନ୍ତି: ଏହି ୱେବସାଇଟର ଆଉ କିଛି ପଢ଼ିବା ପୂର୍ବରୁ /docs ପଢ଼ନ୍ତୁ। API ହେଉଛି ଉତ୍ପାଦ କ'ଣ କରେ ତାହାର ସତ୍ୟବାଦୀ ବର୍ଣ୍ଣନା, ଏବଂ ଏହି ପୃଷ୍ଠାଗୁଡ଼ିକର ପ୍ରତ୍ୟେକ ଦାବି ସେଠାରେ ମିଳୁଥିବା ଏକ ମାର୍ଗ କିମ୍ବା ନୋଡ୍ ପ୍ରକାର ସହ ସଂଯୁକ୍ତ। ସ୍କିମା ବଦଳିଲେ, ଏହି ପୃଷ୍ଠାଗୁଡ଼ିକ ମଧ୍ୟ ବଦଳନ୍ତି।