# এজেন্সি, টিম ও API

এজেন্সি কীভাবে প্রতিটি ক্লায়েন্টের নামে Agilis-এ বিজ্ঞাপন দেয়, টিমের ভূমিকা, ব্যালান্স ও ইনভয়েস কীভাবে কাজ করে, এবং Agilis REST API কীভাবে ব্যবহার করবেন।

**সংক্ষেপে:** একটি এজেন্সি নিজের আইনি নামে একবারই নিবন্ধন করে। এরপর প্রতিটি ক্লায়েন্টের নাম **প্রদর্শিত নাম** ঘরে লিখে তাদের হয়ে বিজ্ঞাপন দেয়। এজেন্সিই অর্থ পরিশোধ করে, ব্যালান্স রাখে এবং ইনভয়েস পায়। ডেভেলপাররা বিজ্ঞাপন পোর্টাল থেকে পাওয়া API কী দিয়ে **Agilis REST API** (https://ads.agilis.dating)-এর মাধ্যমে অফার ও অনুষ্ঠান তৈরি ও পরিচালনা করতে পারেন। পরীক্ষামূলক কী বিনামূল্যে এবং এগুলো দিয়ে তৈরি কিছুই কখনো সদস্যদের দেখানো হয় না।

## এজেন্সির জন্য

1. এজেন্সির নিজের আইনি নামে **এজেন্সি নিবন্ধন করুন**। → [কীভাবে নিবন্ধন করবেন](https://www.agilis.dating/bn/business/guide/register)
2. অফার বা অনুষ্ঠান তৈরির সময় **প্রদর্শিত নাম** ঘরে আপনার **প্রদর্শিত নাম** লিখুন। সদস্যরা আপনার নাম নয়, ক্লায়েন্টের নাম দেখবেন।
3. যাঁদের হয়ে বিজ্ঞাপন দিচ্ছেন, সেই প্রতিটি ক্লায়েন্টের অনুমোদন আপনার থাকতে হবে। বিজ্ঞাপনের শর্তাবলি অনুযায়ী এর দায়িত্ব এজেন্সির।

**কে অর্থ পরিশোধ করবে, আর ইনভয়েস কার নামে হবে**

- আপনার এজেন্সির অ্যাকাউন্ট থেকেই, এজেন্সির বিলিং মুদ্রায় অর্থ পরিশোধ করা হয়।
- আপনার এজেন্সির প্রত্যেকের নিজস্ব ব্যালান্স থাকে এবং তিনি সেখান থেকেই অর্থ দেন। প্রতিষ্ঠানের ব্যালান্স হলো সবার ব্যালান্সের মোট। → [ব্যালান্স কীভাবে কাজ করে](https://www.agilis.dating/bn/business/guide/pricing)
- ইনভয়েস ও ফলাফল আপনার এজেন্সির নামে থাকে, প্রতিটি পেমেন্টের জন্য একটি করে ইনভয়েস। ফলে আপনি প্রতিটি ক্লায়েন্টকে আলাদাভাবে বিল করতে পারেন।
- প্রতিটি ক্লায়েন্টের খরচ আলাদা রাখতে প্রতি ক্লায়েন্টের জন্য আলাদা অফার বা অনুষ্ঠান ব্যবহার করুন। এরপর সেটির ইনভয়েস দেখে ক্লায়েন্টকে বিল করুন।

## টিমের ভূমিকা

প্রতিষ্ঠানের অ্যাডমিন ও বিজ্ঞাপনদাতারা বিজ্ঞাপন পোর্টালে কাজ করেন; ডেভেলপাররা কাজ করেন API-এর মাধ্যমে। ডেভেলপাররা বিজ্ঞাপন পোর্টালে অফার বা অনুষ্ঠান তৈরি করতে পারেন না। তবে নিজেদের API কী দিয়ে API-এর মাধ্যমে সেগুলো তৈরি ও প্রকাশ করতে এবং তার অর্থ পরিশোধ করতে পারেন। আপনার প্রতিষ্ঠানের কীগুলো কীভাবে ব্যবহৃত হচ্ছে, তার দায়িত্ব আপনার প্রতিষ্ঠানের। পূর্ণ সারণিটি পাবেন [টিমের ভূমিকা ও অনুমতি](https://www.agilis.dating/bn/business/guide/getting-started) পাতায়।

## 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 কী নিন

1. প্রতিষ্ঠানের অ্যাডমিন বা ডেভেলপার হিসেবে বিজ্ঞাপন পোর্টালে সাইন ইন করুন।
2. পাতার ওপরের সুইচ দিয়ে **পরীক্ষামূলক মোড** বা লাইভ মোড বেছে নিন।
3. **API কী** → **নতুন কী তৈরি করুন**-এ যান। কীটির একটি নাম দিন এবং চাইলে মেয়াদ শেষের তারিখও দিন।
4. **কীটি এখনই কপি করুন।** এটি আর দেখতে পাবেন না।

পরীক্ষামূলক কী শুরু হয় `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 ঠিকানায় নির্দেশ করুন।

Source: https://www.agilis.dating/bn/business/guide/agencies-and-api