আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য
আপনার API পণ্য বান্ডেলে প্রতিটি API পণ্যের জন্য লেনদেন রেকর্ডিং নীতিগুলি কনফিগার করুন, যেমনটি নিম্নলিখিত বিভাগে বর্ণিত হয়েছে।
ভূমিকা
একটি লেনদেন রেকর্ডিং নীতি লেনদেনের পরামিতি এবং কাস্টম বৈশিষ্ট্যগুলি ক্যাপচার করতে নগদীকরণ সক্ষম করে। মনিটাইজেশনের নগদীকরণ প্রক্রিয়াকরণ যেমন রেট প্ল্যান প্রয়োগ করার জন্য এই তথ্যের প্রয়োজন।
উদাহরণস্বরূপ, আপনি যদি একটি রাজস্ব ভাগ হারের পরিকল্পনা সেট আপ করেন, আপনার নগদীকৃত API পণ্যের সাথে জড়িত প্রতিটি লেনদেন থেকে উত্পন্ন রাজস্বের একটি শতাংশ অনুরোধটি প্রদানকারী অ্যাপের বিকাশকারীর সাথে ভাগ করা হয়। রাজস্ব ভাগ লেনদেনের নেট বা মোট মূল্যের উপর ভিত্তি করে (আপনি কোনটি নির্দিষ্ট করুন), অর্থাৎ, প্রতিটি লেনদেনের মোট বা নেট মূল্যের শতাংশ রাজস্ব ভাগ নির্ধারণ করতে ব্যবহৃত হয়। এই কারণে, নগদীকরণের জন্য প্রযোজ্য হিসাবে একটি লেনদেনের স্থূল বা নেট মূল্য জানতে হবে। এটি আপনার লেনদেন রেকর্ডিং নীতিতে করা সেটিংস থেকে মোট বা নেট মূল্য পায়।
আপনি যদি একটি রেট কার্ড প্ল্যান সেট আপ করেন, যেখানে আপনি প্রতিটি লেনদেনের জন্য বিকাশকারীকে চার্জ করেন, আপনি একটি কাস্টম অ্যাট্রিবিউটের উপর ভিত্তি করে প্ল্যানের জন্য হার সেট করতে পারেন যেমন একটি লেনদেনে প্রেরণ করা বাইট সংখ্যা৷ মনিটাইজেশন জানতে হবে কাস্টম অ্যাট্রিবিউট কী এবং এটি কোথায় পাওয়া যায়। তাই আপনাকে লেনদেন রেকর্ডিং নীতিতে কাস্টম বৈশিষ্ট্য উল্লেখ করতে হবে।
লেনদেন রেকর্ডিং নীতিতে লেনদেনের বৈশিষ্ট্যগুলি নির্দিষ্ট করার পাশাপাশি, আপনি কখন লেনদেন সফল হবে তা নির্ধারণ করতে লেনদেনের সাফল্যের মানদণ্ড নির্দিষ্ট করতে পারেন (চার্জ করার উদ্দেশ্যে)। লেনদেনের সাফল্যের মানদণ্ড সেট করার উদাহরণগুলির জন্য, একটি লেনদেন রেকর্ডিং নীতিতে লেনদেনের সাফল্যের মানদণ্ড সেট করার উদাহরণগুলি দেখুন। আপনি একটি API পণ্যের জন্য কাস্টম বৈশিষ্ট্যগুলিও নির্দিষ্ট করতে পারেন (যার ভিত্তিতে আপনি বেস রেট প্ল্যান চার্জ করেন)।
একটি লেনদেন রেকর্ডিং নীতি কনফিগার করা
নীচে বর্ণিত হিসাবে পণ্য বান্ডেল পৃষ্ঠা অ্যাক্সেস করুন।
প্রান্ত
এজ UI ব্যবহার করে একটি API পণ্য বান্ডেল যোগ করার সময়, আপনাকে নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করে লেনদেন রেকর্ডিং নীতি কনফিগার করতে হবে:
- লেনদেন রেকর্ডিং নীতি বিভাগে কনফিগার করার জন্য API পণ্যটি নির্বাচন করুন (যদি পণ্য বান্ডেলে একাধিক API পণ্য থাকে)।
- লেনদেনের বৈশিষ্ট্যগুলি কনফিগার করুন ।
- কাস্টম বৈশিষ্ট্যগুলি কনফিগার করুন ।
- অনন্য লেনদেন আইডিগুলির সাথে সংস্থানগুলি লিঙ্ক করুন ৷
- ফেরত কনফিগার করুন .
- API পণ্য বান্ডেলে সংজ্ঞায়িত প্রতিটি API পণ্যের জন্য পুনরাবৃত্তি করুন।
ক্লাসিক এজ (ব্যক্তিগত ক্লাউড)
ক্লাসিক এজ UI ব্যবহার করে একটি লেনদেন রেকর্ডিং নীতি কনফিগার করতে:
-
http:// ms-ip :9000
এ সাইন ইন করুন, যেখানে ms-ip হল ম্যানেজমেন্ট সার্ভার নোডের IP ঠিকানা বা DNS নাম। - শীর্ষ নেভিগেশন বারে প্রকাশ > পণ্য নির্বাচন করুন।
- প্রযোজ্য API পণ্যের জন্য সারিতে + লেনদেন রেকর্ডিং নীতিতে ক্লিক করুন। নতুন লেনদেন রেকর্ডিং নীতি উইন্ডো প্রদর্শিত হয়.
- নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করে লেনদেন রেকর্ডিং নীতি কনফিগার করুন:
- Save এ ক্লিক করুন।
লেনদেনের বৈশিষ্ট্যগুলি কনফিগার করা হচ্ছে
লেনদেন বৈশিষ্ট্য বিভাগে, একটি সফল নগদীকরণ লেনদেন নির্দেশ করে এমন মানদণ্ড নির্দিষ্ট করুন৷
- লেনদেন সফলতার মাপকাঠি ক্ষেত্রে, লেনদেন সফল হলে (চার্জ করার উদ্দেশ্যে) নির্ধারণের জন্য স্ট্যাটাস অ্যাট্রিবিউটের (পরে বর্ণিত) মানের উপর ভিত্তি করে অভিব্যক্তিটি নির্দিষ্ট করুন। যে লেনদেনগুলি সফল হয় না (অর্থাৎ, তারা অভিব্যক্তিতে মানদণ্ড পূরণ করে না) রেকর্ড করা হয়, তবে তাদের জন্য হার পরিকল্পনা প্রয়োগ করা হয় না। যেমন:
txProviderStatus == 'OK'
- স্ট্যাটাস অ্যাট্রিবিউটে লেনদেন সফলতার মাপকাঠি ক্ষেত্রে কনফিগার করা অভিব্যক্তি দ্বারা ব্যবহৃত মান রয়েছে। নিম্নলিখিত ক্ষেত্রগুলি সংজ্ঞায়িত করে স্ট্যাটাস অ্যাট্রিবিউট কনফিগার করুন:
মাঠ বর্ণনা API সম্পদ API পণ্যে সংজ্ঞায়িত URI প্যাটার্ন যা নগদীকৃত লেনদেন শনাক্ত করতে ব্যবহার করা হবে। প্রতিক্রিয়া অবস্থান প্রতিক্রিয়ার অবস্থান যেখানে অ্যাট্রিবিউট নির্দিষ্ট করা আছে। বৈধ মানগুলির মধ্যে রয়েছে: ফ্লো ভেরিয়েবল, হেডার, JSON বডি এবং এক্সএমএল বডি। মান প্রতিক্রিয়া মূল্য. একাধিক মান নির্দিষ্ট করতে, ক্লিক করুন + যোগ করুন x (উদাহরণস্বরূপ, + ফ্লো ভেরিয়েবল যোগ করুন )। - ঐচ্ছিক লেনদেন বৈশিষ্ট্যগুলি কনফিগার করতে, ঐচ্ছিক বৈশিষ্ট্যগুলি ব্যবহার করুন টগল সক্ষম করুন এবং নিম্নলিখিত সারণীতে সংজ্ঞায়িত যে কোনও লেনদেনের বৈশিষ্ট্যগুলি কনফিগার করুন৷
বৈশিষ্ট্য বর্ণনা মোট মূল্য এই বৈশিষ্ট্যটি শুধুমাত্র রেট প্ল্যানের জন্য প্রযোজ্য যা রাজস্ব ভাগের মডেল ব্যবহার করে। এই রেট প্ল্যানগুলির জন্য, হয় মোট মূল্য বা নেট মূল্য বাধ্যতামূলক৷ নিশ্চিত করুন যে সাংখ্যিক মান একটি স্ট্রিং টাইপ হিসাবে প্রকাশ করা হয়েছে। একটি লেনদেনের জন্য মোট মূল্য। রাজস্ব ভাগের পরিকল্পনার জন্য, আপনাকে গ্রস প্রাইস অ্যাট্রিবিউট বা নেট প্রাইস অ্যাট্রিবিউট রেকর্ড করতে হবে। কোন বৈশিষ্ট্যের প্রয়োজন তা নির্ভর করে রাজস্ব ভাগের ভিত্তিতে। উদাহরণস্বরূপ, আপনি একটি রাজস্ব ভাগ হার পরিকল্পনা সেট আপ করতে পারেন যা একটি লেনদেনের মোট মূল্যের উপর ভিত্তি করে। সেই ক্ষেত্রে, গ্রস প্রাইস ফিল্ড প্রয়োজন।
নেট মূল্য এই বৈশিষ্ট্যটি শুধুমাত্র রেট প্ল্যানের জন্য প্রযোজ্য যা রাজস্ব ভাগের মডেল ব্যবহার করে। এই রেট প্ল্যানগুলির জন্য, হয় মোট মূল্য বা নেট মূল্য বাধ্যতামূলক৷ নিশ্চিত করুন যে সাংখ্যিক মান একটি স্ট্রিং টাইপ হিসাবে প্রকাশ করা হয়েছে। একটি লেনদেনের জন্য নেট মূল্য। রাজস্ব ভাগের পরিকল্পনার জন্য, আপনাকে হয় নেট প্রাইস ফিল্ড বা গ্রস প্রাইস ফিল্ড রেকর্ড করতে হবে। কোন ক্ষেত্রের প্রয়োজন তা নির্ভর করে রাজস্ব ভাগের ভিত্তিতে। উদাহরণস্বরূপ, আপনি একটি রাজস্ব ভাগের হার পরিকল্পনা সেট আপ করতে পারেন যা একটি লেনদেনের নেট মূল্যের উপর ভিত্তি করে। সেই ক্ষেত্রে, নেট প্রাইস ফিল্ড প্রয়োজন।
মুদ্রা এই বৈশিষ্ট্যটি রেট প্ল্যানের জন্য প্রয়োজন যা রাজস্ব ভাগের মডেল ব্যবহার করে। লেনদেনের ক্ষেত্রে প্রযোজ্য মুদ্রার প্রকার।
ত্রুটি কোড লেনদেনের সাথে সম্পর্কিত ত্রুটি কোড। এটি একটি ব্যর্থ লেনদেন সম্পর্কে আরও তথ্য প্রদান করে।
আইটেম বিবরণ লেনদেনের বিবরণ।
ট্যাক্স এই বৈশিষ্ট্যটি শুধুমাত্র রাজস্ব ভাগ করে নেওয়ার মডেলগুলির জন্য প্রাসঙ্গিক এবং শুধুমাত্র যদি করের পরিমাণ API কলগুলিতে ক্যাপচার করা হয়। নিশ্চিত করুন যে সাংখ্যিক মান একটি স্ট্রিং টাইপ হিসাবে প্রকাশ করা হয়েছে। ক্রয়ের উপর করের পরিমাণ। নিট মূল্য প্লাস ট্যাক্স = মোট মূল্য।
উদাহরণস্বরূপ, নিম্নলিখিত মানগুলি সেট করার মাধ্যমে, নগদীকরণ বার্তা প্রতিক্রিয়া থেকে response.reason.phrase
নামক একটি ভেরিয়েবলে ফ্লো ভেরিয়েবলের মান পায়। যদি মান ঠিক থাকে, এবং নগদীকরণ সীমা চেক নীতি API প্রক্সি প্রক্সিএন্ডপয়েন্ট অনুরোধের সাথে সংযুক্ত থাকে, নগদীকরণ এটিকে একটি লেনদেন হিসাবে গণনা করে।
মাঠ | মান |
---|---|
লেনদেন সফলতার মানদণ্ড | txProviderStatus == 'OK' |
স্থিতি: API সম্পদ | ** |
স্থিতি: প্রতিক্রিয়া অবস্থান | প্রবাহ পরিবর্তনশীল |
স্থিতি: প্রবাহ পরিবর্তনশীল | response.reason.phrase |
কাস্টম বৈশিষ্ট্য কনফিগার করা হচ্ছে
কাস্টম অ্যাট্রিবিউট বিভাগে, আপনি লেনদেন রেকর্ডিং নীতিতে অন্তর্ভুক্ত করার জন্য কাস্টম বৈশিষ্ট্যগুলি সনাক্ত করেন। উদাহরণস্বরূপ, যদি আপনি একটি রেট কার্ড প্ল্যান সেট আপ করেন, যেখানে আপনি প্রতিটি লেনদেনের জন্য বিকাশকারীকে চার্জ করেন, আপনি একটি কাস্টম বৈশিষ্ট্যের উপর ভিত্তি করে পরিকল্পনার জন্য হার সেট করতে পারেন যেমন একটি লেনদেনে প্রেরণ করা বাইট সংখ্যা৷ তারপর আপনাকে লেনদেন রেকর্ডিং নীতিতে সেই কাস্টম বৈশিষ্ট্যটি অন্তর্ভুক্ত করতে হবে।
এই বৈশিষ্ট্যগুলির প্রতিটি লেনদেন লগে সংরক্ষণ করা হয়, যা আপনি জিজ্ঞাসা করতে পারেন। আপনি যখন একটি রেট প্ল্যান তৈরি করেন তখন সেগুলিও প্রদর্শিত হয় (যাতে আপনি পরিকল্পনার জন্য আপনার হারের ভিত্তিতে এই বৈশিষ্ট্যগুলির মধ্যে এক বা একাধিক চয়ন করতে পারেন)।
আপনি আপনার রাজস্ব সারাংশ রিপোর্টে লেনদেন রেকর্ডিং নীতিতে সংজ্ঞায়িত কাস্টম বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করতে পারেন, যেমন রাজস্ব সারসংক্ষেপ প্রতিবেদনে কাস্টম লেনদেনের বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করা হয়েছে।
কাস্টম অ্যাট্রিবিউট কনফিগার করতে, কাস্টম অ্যাট্রিবিউট ব্যবহার করুন টগল সক্ষম করুন এবং 10টি পর্যন্ত কাস্টম অ্যাট্রিবিউট নির্ধারণ করুন। প্রতিটি কাস্টম বৈশিষ্ট্যের জন্য যা আপনি লেনদেন রেকর্ডিং নীতিতে অন্তর্ভুক্ত করেছেন, আপনাকে নিম্নলিখিত তথ্য উল্লেখ করতে হবে।
মাঠ | বর্ণনা |
---|---|
কাস্টম বৈশিষ্ট্যের নাম | একটি নাম লিখুন যা কাস্টম বৈশিষ্ট্য বর্ণনা করে। যদি রেট প্ল্যানটি একটি কাস্টম অ্যাট্রিবিউটের উপর ভিত্তি করে হয়, তাহলে এই নামটি রেট প্ল্যানের বিবরণে ব্যবহারকারীর কাছে প্রদর্শিত হয়। উদাহরণস্বরূপ, যদি কাস্টম অ্যাট্রিবিউট সময়কাল ক্যাপচার করে, তাহলে আপনার অ্যাট্রিবিউটের সময়কালের নাম দেওয়া উচিত। আপনি যখন একটি কাস্টম অ্যাট্রিবিউট রেট প্ল্যান তৈরি করেন তখন কাস্টম অ্যাট্রিবিউটের প্রকৃত ইউনিট (যেমন ঘন্টা, মিনিট বা সেকেন্ড) রেটিং ইউনিট ক্ষেত্রে সেট করা হয় ( কাস্টম অ্যাট্রিবিউটের বিবরণ সহ রেট প্ল্যান নির্দিষ্ট করুন দেখুন)। |
API সম্পদ | লেনদেনে অ্যাক্সেস করা API সম্পদের এক বা একাধিক URI প্রত্যয় (অর্থাৎ, বেস পাথ অনুসরণ করে URI খণ্ড) নির্বাচন করুন। উপলব্ধ সংস্থানগুলি লেনদেনের বৈশিষ্ট্যগুলির মতোই৷ |
প্রতিক্রিয়া অবস্থান | প্রতিক্রিয়াতে অবস্থানটি নির্বাচন করুন যেখানে বৈশিষ্ট্যটি নির্দিষ্ট করা হয়েছে। বৈধ মানগুলির মধ্যে রয়েছে: ফ্লো ভেরিয়েবল, হেডার, JSON বডি এবং এক্সএমএল বডি। |
মান | কাস্টম বৈশিষ্ট্যের জন্য একটি মান নির্দিষ্ট করুন। আপনার নির্দিষ্ট করা প্রতিটি মান একটি ক্ষেত্র, পরামিতি বা বিষয়বস্তুর উপাদানের সাথে সম্পর্কিত যা আপনার নির্দিষ্ট করা অবস্থানে কাস্টম বৈশিষ্ট্য প্রদান করে। একাধিক মান নির্দিষ্ট করতে, ক্লিক করুন + যোগ করুন x (উদাহরণস্বরূপ, + ফ্লো ভেরিয়েবল যোগ করুন )। উদাহরণস্বরূপ, আপনি যদি সামগ্রীর দৈর্ঘ্য নামে একটি কাস্টম বৈশিষ্ট্য কনফিগার করেন এবং প্রতিক্রিয়া অবস্থান হিসাবে শিরোনাম নির্বাচন করেন, যদি HTTP সামগ্রী-দৈর্ঘ্য ক্ষেত্রে সামগ্রীর দৈর্ঘ্যের মান প্রদান করা হয়, তাহলে আপনি মান হিসাবে |
অনন্য লেনদেন আইডি সহ সংস্থান লিঙ্ক করুন
কিছু লেনদেন সহজ, একটি সম্পদে একটি API কল জড়িত। তবে, অন্যান্য লেনদেন আরও জটিল হতে পারে। উদাহরণ স্বরূপ, ধরুন একটি মোবাইল গেমিং অ্যাপে একটি ইন-অ্যাপ পণ্য কেনার জন্য একটি লেনদেনে একাধিক রিসোর্স কল জড়িত:
- একটি রিজার্ভ API-এ একটি কল যা নিশ্চিত করে যে একজন প্রিপেইড ব্যবহারকারীর পণ্য কেনার জন্য যথেষ্ট ক্রেডিট রয়েছে এবং ক্রয়ের জন্য তহবিল বরাদ্দ ("রিজার্ভ") করে৷
- একটি চার্জ API-এ একটি কল যা প্রিপেইড ব্যবহারকারীর অ্যাকাউন্ট থেকে তহবিল কেটে নেয়।
সম্পূর্ণ লেনদেন প্রক্রিয়া করার জন্য, নগদীকরণের জন্য প্রথম সংস্থান (রিজার্ভ এপিআই থেকে এবং এর থেকে কল এবং প্রতিক্রিয়া) দ্বিতীয় সংস্থান (চার্জ API থেকে এবং থেকে কল এবং প্রতিক্রিয়া) লিঙ্ক করার একটি উপায় প্রয়োজন। এটি করার জন্য, এটি অনন্য লেনদেন আইডি সহ লিঙ্ক সংস্থান বিভাগে আপনার উল্লেখ করা তথ্যের উপর নির্ভর করে।
কাস্টম অ্যাট্রিবিউট কনফিগার করতে, ইউনিক ট্রানজ্যাকশন আইডি চালু করুন টগল করুন এবং লেনদেন লিঙ্ক করুন। প্রতিটি লেনদেনের জন্য, আপনি একটি সংস্থান, প্রতিক্রিয়ার অবস্থান এবং বৈশিষ্ট্যের মান নির্দিষ্ট করেন যা অন্যান্য লেনদেনের সংশ্লিষ্ট মানগুলির সাথে লিঙ্ক করা হয়।
উদাহরণ স্বরূপ, ধরুন রিজার্ভ এপিআই কল এবং চার্জ এপিআই কলটি নিম্নরূপ লিঙ্ক করা হয়েছে: রিজার্ভ এপিআই থেকে রেসপন্স হেডারে session_id
নামের একটি ফিল্ড চার্জ এপিআই থেকে reference_id
নামের একটি রেসপন্স হেডারের সাথে মিলে যায়। এই ক্ষেত্রে, আপনি লিংক রিসোর্সেস উইথ ইউনিক ট্রানজেকশন আইডি বিভাগে এন্ট্রি সেট করতে পারেন:
সম্পদ | প্রতিক্রিয়া অবস্থান | মান |
---|---|---|
reserve/{id}** | হেডার | session_id |
/charge/{id}** | হেডার | reference_id |
ফেরত কনফিগার করা হচ্ছে
অর্থ ফেরত বিভাগে , আপনি এমন বৈশিষ্ট্যগুলি নির্দিষ্ট করেন যা নগদীকরণ অর্থ ফেরত প্রক্রিয়া করতে ব্যবহার করে।
উদাহরণস্বরূপ, ধরুন একজন ব্যবহারকারী একটি মোবাইল অ্যাপ থেকে একটি পণ্য ক্রয় করে যা আপনার নগদীকৃত API ব্যবহার করে। শেয়ার করা রাজস্ব পরিকল্পনার উপর ভিত্তি করে লেনদেনটি নগদীকরণ করা হয়। যাইহোক, ধরুন ব্যবহারকারী পণ্যটির সাথে অসন্তুষ্ট এবং এটি ফেরত দিতে চায়। যদি পণ্যটি আপনার API-তে একটি কল ব্যবহার করে ফেরত দেওয়া হয় যা ফেরত দেয়, নগদীকরণ প্রয়োজনীয় নগদীকরণ সমন্বয় করে। লেনদেন রেকর্ডিং নীতির রিফান্ড বিভাগে আপনি যে তথ্য উল্লেখ করেছেন তার ভিত্তিতে এটি এটি করে।
রিফান্ড কনফিগার করতে, ইউজ রিফান্ড অ্যাট্রিবিউট টগল সক্ষম করুন এবং রিফান্ডের বিবরণ সংজ্ঞায়িত করুন:
- নিম্নলিখিত ক্ষেত্রগুলি সংজ্ঞায়িত করে অর্থ ফেরতের মানদণ্ড নির্ধারণ করুন:
মাঠ বর্ণনা প্রতিক্রিয়া অবস্থান রিফান্ড লেনদেনের জন্য সম্পদ। যদি API পণ্য একাধিক সংস্থান সরবরাহ করে, আপনি শুধুমাত্র সেই সংস্থানটি নির্বাচন করতে পারেন যা ফেরত প্রদান করে। ফেরত সফলতার মানদণ্ড কখন ফেরত লেনদেন সফল হয় তা নির্ধারণের জন্য স্ট্যাটাস অ্যাট্রিবিউটের (পরে বর্ণিত) মানের উপর ভিত্তি করে অভিব্যক্তি (চার্জ করার উদ্দেশ্যে)। রিফান্ড লেনদেনগুলি যেগুলি সফল নয় (অর্থাৎ, তারা অভিব্যক্তিতে মানদণ্ড পূরণ করে না) রেকর্ড করা হয়, তবে তাদের উপর রেট প্ল্যান প্রয়োগ করা হয় না। যেমন: txProviderStatus == 'OK'
- নিম্নলিখিত ক্ষেত্রগুলি সংজ্ঞায়িত করে স্ট্যাটাস অ্যাট্রিবিউট কনফিগার করুন:
মাঠ বর্ণনা প্রতিক্রিয়া অবস্থান প্রতিক্রিয়ার অবস্থান যেখানে অ্যাট্রিবিউট নির্দিষ্ট করা আছে। বৈধ মানগুলির মধ্যে রয়েছে: ফ্লো ভেরিয়েবল, হেডার, JSON বডি এবং এক্সএমএল বডি। মান প্রতিক্রিয়া মূল্য. একাধিক মান নির্দিষ্ট করতে, ক্লিক করুন + যোগ করুন x (উদাহরণস্বরূপ, + ফ্লো ভেরিয়েবল যোগ করুন )। - নিম্নলিখিত ক্ষেত্রগুলি সংজ্ঞায়িত করে অভিভাবক আইডি বৈশিষ্ট্য কনফিগার করুন:
মাঠ বর্ণনা প্রতিক্রিয়া অবস্থান প্রতিক্রিয়ার অবস্থান যেখানে অ্যাট্রিবিউট নির্দিষ্ট করা আছে। বৈধ মানগুলির মধ্যে রয়েছে: ফ্লো ভেরিয়েবল, হেডার, JSON বডি এবং এক্সএমএল বডি। মান লেনদেনের আইডি যার জন্য অর্থ ফেরত প্রক্রিয়া করা হয়েছে। উদাহরণস্বরূপ, যদি একজন ব্যবহারকারী একটি পণ্য ক্রয় করে এবং তারপরে অর্থ ফেরতের অনুরোধ করে, তাহলে প্যারেন্ট লেনদেন আইডি হল ক্রয় লেনদেনের আইডি। একাধিক মান নির্দিষ্ট করতে, ক্লিক করুন + যোগ করুন x (উদাহরণস্বরূপ, + ফ্লো ভেরিয়েবল যোগ করুন )। - ঐচ্ছিক রিফান্ড অ্যাট্রিবিউট কনফিগার করতে, ইউজ অপশনাল রিফান্ড অ্যাট্রিবিউটস টগল করুন এবং অ্যাট্রিবিউট কনফিগার করুন। ঐচ্ছিক অর্থ ফেরতের বৈশিষ্ট্যগুলি ঐচ্ছিক লেনদেন বৈশিষ্ট্যগুলির মতোই, যেমনটি লেনদেন বৈশিষ্ট্যগুলি কনফিগার করাতে সংজ্ঞায়িত করা হয়েছে৷
API ব্যবহার করে লেনদেন রেকর্ডিং নীতি পরিচালনা করা
নিম্নলিখিত বিভাগগুলি API ব্যবহার করে লেনদেন রেকর্ডিং নীতিগুলি কীভাবে পরিচালনা করতে হয় তা বর্ণনা করে৷
API ব্যবহার করে একটি লেনদেন রেকর্ডিং নীতি তৈরি করা
আপনি একটি API পণ্যের বৈশিষ্ট্য হিসাবে একটি লেনদেন রেকর্ডিং নীতি নির্দিষ্ট করুন৷ বৈশিষ্ট্যের মান সনাক্ত করে:
- পণ্য সম্পদের URI প্রত্যয় যেখানে লেনদেন রেকর্ডিং নীতি সংযুক্ত করা হয়েছে। প্রত্যয়টিতে একটি প্যাটার্ন পরিবর্তনশীল রয়েছে যা কোঁকড়া ধনুর্বন্ধনীতে আবদ্ধ। প্যাটার্ন ভেরিয়েবল রানটাইমে API পরিষেবা দ্বারা মূল্যায়ন করা হয়। উদাহরণস্বরূপ, নিম্নলিখিত URI প্রত্যয় প্যাটার্ন পরিবর্তনশীল
{id}
অন্তর্ভুক্ত করে।/reserve/{id}**
এই ক্ষেত্রে, API পরিষেবাগুলি সংস্থানের URI প্রত্যয়টিকে
/reserve
হিসাবে মূল্যায়ন করে যার পরে API প্রদানকারীর দ্বারা সংজ্ঞায়িত একটি আইডি দিয়ে শুরু হওয়া যেকোনো সাব-ডিরেক্টরি দ্বারা অনুসরণ করা হয়। - উত্তরে যে সংস্থানটি সংযুক্ত করা হয়েছে। একটি API পণ্য একাধিক সংস্থান থাকতে পারে এবং প্রতিটি সংস্থান সেই সংস্থান থেকে একটি প্রতিক্রিয়ার সাথে সংযুক্ত একটি লেনদেন রেকর্ডিং নীতি থাকতে পারে।
- একটি এক্সট্র্যাক্ট পরিবর্তনশীল নীতি যা লেনদেন রেকর্ডিং নীতিকে আপনি ক্যাপচার করতে চান এমন লেনদেনের পরামিতিগুলির জন্য একটি প্রতিক্রিয়া বার্তা থেকে সামগ্রী বের করতে সক্ষম করে৷
আপনি ম্যানেজমেন্ট API https://api.enterprise.apigee.com/v1/organizations/ {org_name} /apiproducts/ {apiproduct_Id}
(এবং একটিতে নয় নগদীকরণ API)।
API ব্যবহার করে লেনদেনের সাফল্যের মানদণ্ড নির্দিষ্ট করা
কোন লেনদেন কখন সফল হয় তা নির্ধারণের জন্য আপনি লেনদেনের সাফল্যের মানদণ্ড নির্দিষ্ট করতে পারেন (চার্জ করার উদ্দেশ্যে)। যে লেনদেনগুলি সফল হয় না (অর্থাৎ, তারা অভিব্যক্তিতে মানদণ্ড পূরণ করে) রেকর্ড করা হয়, কিন্তু রেট প্ল্যানগুলি তাদের উপর প্রয়োগ করা হয় না। লেনদেনের সাফল্যের মানদণ্ড সেট করার উদাহরণগুলির জন্য, একটি লেনদেন রেকর্ডিং নীতিতে লেনদেনের সাফল্যের মানদণ্ড সেট করার উদাহরণগুলি দেখুন।
আপনি একটি API পণ্যের একটি বৈশিষ্ট্য হিসাবে লেনদেনের সাফল্যের মানদণ্ড নির্দিষ্ট করুন৷ ব্যবস্থাপনা API https://api.enterprise.apigee.com/v1/organizations/ {org_name} /apiproducts/ {apiproduct_Id}
(এবং নগদীকরণ API-কে নয়) একটি PUT অনুরোধ জারি করে এটি করুন৷
উদাহরণস্বরূপ, নিম্নলিখিত অনুরোধে একটি লেনদেন সফল হয় যদি txProviderStatus
এর মান success
হয় (লেনদেনের সাফল্যের মানদণ্ড-সম্পর্কিত বৈশিষ্ট্যগুলি হাইলাইট করা হয়)।
$ curl -H "Content-Type: application/json" -X PUT -d \ '{ "apiResources": [ "/reserve/{id}**" ], "approvalType": "auto", "attributes": [ { "name": "MINT_TRANSACTION_SUCCESS_CRITERIA", "value": "txProviderStatus == 'OK'" } ], "description": "Payment", "displayName": "Payment", "environments": [ "dev" ], "name": "payment", "proxies": [], "scopes": [ "" ] }' \ "https://api.enterprise.apigee.com/v1/organizations/{org_name}/apiproducts/payment" \ -u email:password
API ব্যবহার করে কাস্টম বৈশিষ্ট্য নির্দিষ্ট করা
আপনি একটি API পণ্যের জন্য কাস্টম বৈশিষ্ট্য নির্দিষ্ট করতে পারেন যার উপর আপনি বেস রেট প্ল্যান চার্জ করেন। উদাহরণস্বরূপ, যদি আপনি একটি রেট কার্ড প্ল্যান সেট আপ করেন, যেখানে আপনি প্রতিটি লেনদেনের জন্য বিকাশকারীকে চার্জ করেন, আপনি একটি কাস্টম বৈশিষ্ট্যের উপর ভিত্তি করে পরিকল্পনার জন্য হার সেট করতে পারেন যেমন একটি লেনদেনে প্রেরণ করা বাইট সংখ্যা৷ আপনি যখন একটি রেট প্ল্যান তৈরি করেন, তখন আপনি এক বা একাধিক কাস্টম বৈশিষ্ট্য নির্দিষ্ট করতে পারেন যার উপর ভিত্তি করে প্ল্যানের জন্য আপনার হার নির্ধারণ করা হবে। যাইহোক, একটি রেট প্ল্যানে যেকোন নির্দিষ্ট পণ্যের শুধুমাত্র একটি কাস্টম বৈশিষ্ট্য থাকতে পারে যার ভিত্তিতে প্ল্যানের হার নির্ধারণ করা হবে।
আপনি একটি API পণ্যের বৈশিষ্ট্য হিসাবে কাস্টম বৈশিষ্ট্য নির্দিষ্ট করুন৷ ব্যবস্থাপনা API https://api.enterprise.apigee.com/v1/organizations/ {org_name} /apiproducts/ {apiproduct_Id}
(এবং নগদীকরণ API-কে নয়) একটি PUT অনুরোধ জারি করে এটি করুন৷
প্রতিটি কাস্টম বৈশিষ্ট্যের জন্য যা আপনি একটি API পণ্যে যোগ করেন, আপনাকে একটি নাম এবং একটি বৈশিষ্ট্যের মান উল্লেখ করতে হবে। নামটি MINT_CUSTOM_ATTRIBUTE_ {num}
আকারে হতে হবে, যেখানে {num} একটি পূর্ণসংখ্যা।
উদাহরণস্বরূপ, নিম্নলিখিত অনুরোধ তিনটি কাস্টম বৈশিষ্ট্য নির্দিষ্ট করে।
$ curl -H "Content-Type: application/json" -X PUT -d \ '{ "apiResources": [ "/reserve/{id}**", "/charge/{id}**" ], "approvalType": "auto", "attributes": [ { "name": "MINT_CUSTOM_ATTRIBUTE_1", "value": "test1" }, { "name": "MINT_CUSTOM_ATTRIBUTE_2", "value": "test2" } ], "name": "payment", "proxies": [], "scopes": [ "" ] }' \ "https://api.enterprise.apigee.com/v1/organizations/{org_name}/apiproducts/payment" \ -u email:password
একটি লেনদেন রেকর্ডিং নীতিতে লেনদেনের সাফল্যের মানদণ্ড সেট করার উদাহরণ
নিম্নলিখিত সারণী সফল এবং অসফল লেনদেনের উদাহরণ প্রদান করে, লেনদেনের সাফল্যের মানদণ্ডের অভিব্যক্তি এবং API প্রক্সি দ্বারা প্রত্যাবর্তিত txProviderStatus
মানের উপর ভিত্তি করে। txProviderStatus
হল অভ্যন্তরীণ পরিবর্তনশীল যা নগদীকরণ লেনদেনের সাফল্য নির্ধারণ করতে ব্যবহার করে।
সাফল্যের মানদণ্ডের অভিব্যক্তি | বৈধ অভিব্যক্তি? | API প্রক্সি থেকে txProviderStatus মান | মূল্যায়ন ফলাফল |
---|---|---|---|
null | সত্য | "200" | মিথ্যা |
"" | মিথ্যা | "200" | মিথ্যা |
" " | মিথ্যা | "200" | মিথ্যা |
"sdfsdfsdf" | মিথ্যা | "200" | মিথ্যা |
"txProviderStatus =='100'" | সত্য | "200" | মিথ্যা |
"txProviderStatus =='200'" | সত্য | "200" | সত্য |
"true" | সত্য | "200" | সত্য |
"txProviderStatus=='OK' OR | সত্য | "OK" | সত্য |
"txProviderStatus matches '(OK)|(Not Found)|(Bad Request)'" | সত্য | "OK" | সত্য |
"txProviderStatus matches '(OK)|(Not Found)|(Bad Request)'" | সত্য | "Not Found" | সত্য |
"txProviderStatus matches '(OK)|(Not Found)|(Bad Request)'" | সত্য | "Bad Request" | সত্য |
"(txProviderStatus?:'') matches '(?i)(OK)|(Not Found)|(Bad Request)'" | সত্য | "Bad Request" | সত্য |
"(txProviderStatus?:'') matches '(?i)(OK)|(Not Found)|(Bad Request)'" | সত্য | null | মিথ্যা |
"txProviderStatus matches '(?i)(OK)|(Not Found)|(Bad Request)'" | সত্য | "bad request" | সত্য |
"txProviderStatus matches '(?i)(OK)|(Not Found)|(Bad Request)'" | সত্য | "Redirect" | মিথ্যা |
"txProviderStatus matches '(?i)(OK)|(Not Found)|(Bad Request)'" | সত্য | "heeeelllooo" | মিথ্যা |
"txProviderStatus matches '(?i)(OK)|(Not Found)|(Bad Request)'" | সত্য | null | মিথ্যা |
"txProviderStatus == 100" | সত্য | "200" | মিথ্যা |