# ایجنسیاں، ٹیمیں اور API

ایجنسیاں Agilis پر ہر کلائنٹ کے نام سے کیسے اشتہار دیں، ٹیم کے کردار، بیلنس اور انوائسز کیسے کام کرتے ہیں، اور Agilis REST API کیسے استعمال کریں۔

**مختصراً:** ایجنسی اپنے قانونی نام سے ایک بار رجسٹر ہوتی ہے اور **اراکین کو دکھایا جانے والا نام** میں ہر کلائنٹ کا نام درج کر کے اپنے کلائنٹس کے لیے اشتہار دیتی ہے۔ ادائیگی ایجنسی کرتی ہے، بیلنس اسی کے پاس رہتے ہیں اور انوائسز بھی اسی کو ملتی ہیں۔ ڈویلپرز اشتہاری پورٹل سے حاصل کردہ API کلیدوں کے ذریعے **Agilis REST API** (https://ads.agilis.dating) سے پیشکشیں اور تقریبات بنا اور ان کا انتظام کر سکتے ہیں۔ آزمائشی کلیدیں مفت ہیں اور ان سے بنی چیزیں اراکین کو کبھی نہیں دکھائی جاتیں۔

## ایجنسیوں کے لیے

1. **ایجنسی کو رجسٹر کریں**، اس کے اپنے قانونی نام سے۔ ← [رجسٹر کرنے کا طریقہ](https://www.agilis.dating/ur/business/guide/register)
2. پیشکش یا تقریب بناتے وقت **اراکین کو دکھایا جانے والا نام** میں اپنے **اراکین کو دکھایا جانے والا نام** درج کریں۔ اراکین کو کلائنٹ کا نام نظر آتا ہے، آپ کا نہیں۔
3. ہر کلائنٹ کی طرف سے اس کے لیے اشتہار دینے کی اجازت آپ کے پاس ہونا ضروری ہے۔ اشتہاری شرائط و ضوابط کے تحت اس کی ذمہ داری ایجنسی پر ہے۔

**ادائیگی کون کرتا ہے اور انوائس کسے ملتی ہے**

- ادائیگی آپ کی ایجنسی کے اکاؤنٹ سے، ایجنسی کی بلنگ کرنسی میں ہوتی ہے۔
- آپ کی ایجنسی کے ہر فرد کا اپنا بیلنس ہوتا ہے اور وہ اسی سے ادائیگی کرتا ہے۔ ادارے کا بیلنس ان سب کا مجموعہ ہے۔ ← [بیلنس کیسے کام کرتے ہیں](https://www.agilis.dating/ur/business/guide/pricing)
- انوائسز اور نتائج آپ کی ایجنسی کے نام پر ہوتے ہیں، ہر ادائیگی کی ایک انوائس، تاکہ آپ ہر کلائنٹ کو الگ سے بل بھیج سکیں۔
- ہر کلائنٹ کا خرچ الگ رکھنے کے لیے ہر کلائنٹ کی ایک الگ پیشکش یا تقریب رکھیں اور اسی کی انوائس سے کلائنٹ کو بل بھیجیں۔

## ٹیم کے کردار

ادارے کے منتظمین اور مشتہرین اشتہاری پورٹل میں کام کرتے ہیں؛ ڈویلپرز API کے ذریعے کام کرتے ہیں۔ ڈویلپرز اشتہاری پورٹل میں پیشکشیں یا تقریبات نہیں بنا سکتے، لیکن اپنی API کلیدوں سے وہ API کے ذریعے انہیں بنا، شائع اور ان کی ادائیگی کر سکتے ہیں، اور کلیدوں کے استعمال کی ذمہ داری آپ کے کاروبار پر ہے۔ مکمل جدول [ٹیم کے کردار اور اجازتیں](https://www.agilis.dating/ur/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_` سے۔ ہر فرد ہر موڈ میں زیادہ سے زیادہ 10 کلیدیں رکھ سکتا ہے۔ **کلید بدلیں** کلید کو فوراً بدل دیتا ہے، اس لیے پہلے اپنے سسٹمز کو اپ ڈیٹ کریں۔ کلید `x-api-key` ریکوئسٹ ہیڈر میں بھیجیں: `x-api-key: pk_test_…`۔

### محفوظ طریقے سے تیار کریں

- `pk_test_` کلید کے ساتھ تیار اور آزمائش کریں: آزمائشی پیشکشیں اور تقریبات مفت ہیں اور اراکین کو کبھی نہیں دکھائی جاتیں۔
- پیشکش بنانے سے پہلے قیمت کے تخمینے والے endpoint سے اس کی قیمت معلوم کریں۔
- کلیدیں کوڈ ریپوزٹریز اور براؤزرز سے دور رکھیں؛ API کو اپنے سرور سے کال کریں۔

## سوالات

### کیا ایک ایجنسی ایک ہی اکاؤنٹ سے کئی کلائنٹس کا انتظام کر سکتی ہے؟

جی ہاں۔ ایجنسی کو ایک بار رجسٹر کریں اور ہر پیشکش یا تقریب پر کلائنٹ کا نام درج کریں۔

### کیا ہر کلائنٹ کی الگ انوائس ہو سکتی ہے؟

انوائسز آپ کی ایجنسی کے نام جاری ہوتی ہیں، ہر ادائیگی کی ایک۔ انہی کی بنیاد پر اپنے کلائنٹس کو بل بھیجیں۔

### کیا آزمائش کے لیے کوئی سینڈ باکس موجود ہے؟

جی ہاں۔ `pk_test_` کلیدوں کے ساتھ آزمائشی موڈ ایک مکمل سینڈ باکس ہے۔ نہ کوئی رقم وصول کی جاتی ہے اور نہ ہی کچھ اراکین کو دکھایا جاتا ہے۔

### کیا میں AI کوڈنگ ٹولز منسلک کر سکتا ہوں؟

جی ہاں۔ اپنے ٹول کو www.agilis.dating/api-doc.md یا www.agilis.dating/openapi.json کی طرف رہنمائی دیں۔

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