সংক্ষেপে: একটি এজেন্সি নিজের আইনি নামে একবারই নিবন্ধন করে। এরপর প্রতিটি ক্লায়েন্টের নাম প্রদর্শিত নাম ঘরে লিখে তাদের হয়ে বিজ্ঞাপন দেয়। এজেন্সিই অর্থ পরিশোধ করে, ব্যালান্স রাখে এবং ইনভয়েস পায়। ডেভেলপাররা বিজ্ঞাপন পোর্টাল থেকে পাওয়া API কী দিয়ে Agilis REST API (https://ads.agilis.dating)-এর মাধ্যমে অফার ও অনুষ্ঠান তৈরি ও পরিচালনা করতে পারেন। পরীক্ষামূলক কী বিনামূল্যে এবং এগুলো দিয়ে তৈরি কিছুই কখনো সদস্যদের দেখানো হয় না।
এজেন্সির জন্য
- এজেন্সির নিজের আইনি নামে এজেন্সি নিবন্ধন করুন। → কীভাবে নিবন্ধন করবেন
- অফার বা অনুষ্ঠান তৈরির সময় প্রদর্শিত নাম ঘরে আপনার প্রদর্শিত নাম লিখুন। সদস্যরা আপনার নাম নয়, ক্লায়েন্টের নাম দেখবেন।
- যাঁদের হয়ে বিজ্ঞাপন দিচ্ছেন, সেই প্রতিটি ক্লায়েন্টের অনুমোদন আপনার থাকতে হবে। বিজ্ঞাপনের শর্তাবলি অনুযায়ী এর দায়িত্ব এজেন্সির।
কে অর্থ পরিশোধ করবে, আর ইনভয়েস কার নামে হবে
- আপনার এজেন্সির অ্যাকাউন্ট থেকেই, এজেন্সির বিলিং মুদ্রায় অর্থ পরিশোধ করা হয়।
- আপনার এজেন্সির প্রত্যেকের নিজস্ব ব্যালান্স থাকে এবং তিনি সেখান থেকেই অর্থ দেন। প্রতিষ্ঠানের ব্যালান্স হলো সবার ব্যালান্সের মোট। → ব্যালান্স কীভাবে কাজ করে
- ইনভয়েস ও ফলাফল আপনার এজেন্সির নামে থাকে, প্রতিটি পেমেন্টের জন্য একটি করে ইনভয়েস। ফলে আপনি প্রতিটি ক্লায়েন্টকে আলাদাভাবে বিল করতে পারেন।
- প্রতিটি ক্লায়েন্টের খরচ আলাদা রাখতে প্রতি ক্লায়েন্টের জন্য আলাদা অফার বা অনুষ্ঠান ব্যবহার করুন। এরপর সেটির ইনভয়েস দেখে ক্লায়েন্টকে বিল করুন।
টিমের ভূমিকা
প্রতিষ্ঠানের অ্যাডমিন ও বিজ্ঞাপনদাতারা বিজ্ঞাপন পোর্টালে কাজ করেন; ডেভেলপাররা কাজ করেন API-এর মাধ্যমে। ডেভেলপাররা বিজ্ঞাপন পোর্টালে অফার বা অনুষ্ঠান তৈরি করতে পারেন না। তবে নিজেদের API কী দিয়ে API-এর মাধ্যমে সেগুলো তৈরি ও প্রকাশ করতে এবং তার অর্থ পরিশোধ করতে পারেন। আপনার প্রতিষ্ঠানের কীগুলো কীভাবে ব্যবহৃত হচ্ছে, তার দায়িত্ব আপনার প্রতিষ্ঠানের। পূর্ণ সারণিটি পাবেন টিমের ভূমিকা ও অনুমতি পাতায়।
Agilis REST API
- বেস URL: https://ads.agilis.dating
- রেফারেন্স: www.agilis.dating/api-doc, সঙ্গে cURL, Python, Node.js ও PHP-তে নমুনা এবং একটি API সহকারী
- মেশিনে পড়ার উপযোগী: OpenAPI 3.1: www.agilis.dating/openapi.json; Markdown: www.agilis.dating/api-doc.md; AI টুলের জন্য পূর্ণ লেখা: www.agilis.dating/llms-full.txt
- অফার: আপনার বিভাগ ও আগ্রহগুলোর তালিকা পাওয়া; তৈরির আগে অফারের মূল্য জানা; অফার তৈরি করা, তালিকা দেখা, বিরতি দেওয়া, আবার চালু করা ও মুছে ফেলা; প্রতিটি অফারের ফলাফল দেখা
- অনুষ্ঠান: অনুষ্ঠানের প্রিভিউ দেখা, প্রকাশ করা, তালিকা দেখা, সম্পাদনা করা, সময় বদলানো, বাতিল করা ও মুছে ফেলা; প্রতিটি অনুষ্ঠানের ফলাফল দেখা
একটি API কী নিন
- প্রতিষ্ঠানের অ্যাডমিন বা ডেভেলপার হিসেবে বিজ্ঞাপন পোর্টালে সাইন ইন করুন।
- পাতার ওপরের সুইচ দিয়ে পরীক্ষামূলক মোড বা লাইভ মোড বেছে নিন।
- API কী → নতুন কী তৈরি করুন-এ যান। কীটির একটি নাম দিন এবং চাইলে মেয়াদ শেষের তারিখও দিন।
- কীটি এখনই কপি করুন। এটি আর দেখতে পাবেন না।
পরীক্ষামূলক কী শুরু হয় pk_test_ দিয়ে; লাইভ কী শুরু হয় pk_live_ দিয়ে। প্রত্যেকে প্রতিটি মোডে সর্বোচ্চ ১০টি কী রাখতে পারেন। কী বদলান সঙ্গে সঙ্গে একটি কী প্রতিস্থাপন করে, তাই আগে আপনার সিস্টেম হালনাগাদ করে নিন। কীটি x-api-key রিকোয়েস্ট হেডারে পাঠান: x-api-key: pk_test_…।
নিরাপদে তৈরি করুন
pk_test_কী দিয়ে তৈরি ও পরীক্ষা করুন: পরীক্ষামূলক অফার ও অনুষ্ঠান বিনামূল্যে এবং কখনো সদস্যদের দেখানো হয় না।- অফার তৈরির আগে মূল্য-অনুমানের এন্ডপয়েন্ট দিয়ে তার মূল্য জেনে নিন।
- কীগুলো কোড রিপোজিটরি ও ব্রাউজারের বাইরে রাখুন; API কল করুন আপনার সার্ভার থেকে।
প্রশ্নোত্তর
একটি এজেন্সি কি একটি অ্যাকাউন্ট থেকে একাধিক ক্লায়েন্ট পরিচালনা করতে পারে?
হ্যাঁ। এজেন্সিকে একবার নিবন্ধন করুন এবং প্রতিটি অফার বা অনুষ্ঠানে ক্লায়েন্টের নাম দিন।
প্রতিটি ক্লায়েন্টের জন্য কি আলাদা ইনভয়েস পাওয়া যায়?
ইনভয়েস আপনার এজেন্সির নামে ইস্যু করা হয়, প্রতিটি পেমেন্টের জন্য একটি করে। সেগুলো দেখে আপনার ক্লায়েন্টদের বিল করুন।
স্যান্ডবক্স আছে কি?
হ্যাঁ। pk_test_ কী সহ পরীক্ষামূলক মোড একটি পূর্ণাঙ্গ স্যান্ডবক্স। কোনো অর্থ কাটা হয় না এবং কিছুই সদস্যদের দেখানো হয় না।
আমি কি AI কোডিং টুল যুক্ত করতে পারি?
হ্যাঁ। আপনার টুলকে www.agilis.dating/api-doc.md অথবা www.agilis.dating/openapi.json ঠিকানায় নির্দেশ করুন।
