# एजेंसियाँ, टीम और API

एजेंसियाँ Agilis पर हर क्लाइंट के नाम से विज्ञापन कैसे दें, टीम भूमिकाएँ, बैलेंस और इनवॉइस कैसे काम करते हैं, और Agilis REST API कैसे इस्तेमाल करें।

**संक्षेप में:** एजेंसी अपने क़ानूनी नाम से एक बार पंजीकरण करती है और हर क्लाइंट का नाम **सदस्यों को दिखने वाला नाम** में भरकर अपने क्लाइंटों के लिए विज्ञापन देती है। भुगतान एजेंसी करती है, बैलेंस उसी के पास रहते हैं और इनवॉइस उसी को मिलते हैं। डेवलपर विज्ञापन पोर्टल से मिली API कुंजियों के साथ **Agilis REST API** (https://ads.agilis.dating) के ज़रिए ऑफ़र और कार्यक्रम बना और प्रबंधित कर सकते हैं; टेस्ट कुंजियाँ मुफ़्त हैं और उनसे बना कुछ भी सदस्यों को कभी नहीं दिखता।

## एजेंसियों के लिए

1. **एजेंसी का पंजीकरण करें**, उसके अपने क़ानूनी नाम से। → [पंजीकरण कैसे करें](https://www.agilis.dating/hi/business/guide/register)
2. ऑफ़र या कार्यक्रम बनाते समय, **सदस्यों को दिखने वाला नाम** में अपने **सदस्यों को दिखने वाला नाम** भरें। सदस्यों को क्लाइंट का नाम दिखता है, आपका नहीं।
3. किसी क्लाइंट के लिए विज्ञापन देने हेतु आपके पास उस क्लाइंट की अनुमति होनी चाहिए। विज्ञापन शर्तों के अनुसार इसकी ज़िम्मेदारी एजेंसी की है।

**भुगतान कौन करता है, और इनवॉइस किसे मिलता है**

- भुगतान आपकी एजेंसी के खाते से, आपकी एजेंसी की बिलिंग मुद्रा में होता है।
- आपकी एजेंसी के हर व्यक्ति का अपना बैलेंस होता है और वह उसी से भुगतान करता है। संगठन बैलेंस इन सबका कुल योग है। → [बैलेंस कैसे काम करता है](https://www.agilis.dating/hi/business/guide/pricing)
- इनवॉइस और नतीजे आपकी एजेंसी के नाम पर होते हैं, हर भुगतान का एक इनवॉइस, ताकि आप हर क्लाइंट को आगे बिल कर सकें।
- हर क्लाइंट का ख़र्च अलग रखने के लिए, हर क्लाइंट के लिए अलग ऑफ़र या कार्यक्रम इस्तेमाल करें और उसके इनवॉइस के आधार पर क्लाइंट को बिल करें।

## टीम भूमिकाएँ

संगठन एडमिन और विज्ञापनदाता विज्ञापन पोर्टल में काम करते हैं; डेवलपर API के ज़रिए काम करते हैं। डेवलपर विज्ञापन पोर्टल में ऑफ़र या कार्यक्रम नहीं बना सकते, लेकिन अपनी API कुंजियों से वे API के ज़रिए उन्हें बना सकते हैं, प्रकाशित कर सकते हैं और उनका भुगतान कर सकते हैं, और कुंजियों के उपयोग की ज़िम्मेदारी आपके व्यवसाय की है। पूरी तालिका [टीम भूमिकाएँ और अनुमतियाँ](https://www.agilis.dating/hi/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_` कुंजी से बनाएँ और टेस्ट करें: टेस्ट ऑफ़र और कार्यक्रम मुफ़्त हैं और सदस्यों को कभी नहीं दिखते।
- ऑफ़र बनाने से पहले price-estimate एंडपॉइंट से उसकी कीमत जानें।
- कुंजियों को कोड रिपॉज़िटरी और ब्राउज़र से दूर रखें; API को अपने सर्वर से कॉल करें।

## प्रश्न

### क्या एक एजेंसी एक ही खाते से कई क्लाइंट संभाल सकती है?

हाँ। एजेंसी का एक बार पंजीकरण करें और हर ऑफ़र या कार्यक्रम पर क्लाइंट का नाम दें।

### क्या हर क्लाइंट का अपना इनवॉइस हो सकता है?

इनवॉइस आपकी एजेंसी के नाम जारी होते हैं, हर भुगतान का एक। इनके आधार पर अपने क्लाइंटों को बिल करें।

### क्या कोई सैंडबॉक्स है?

हाँ। `pk_test_` कुंजियों वाला टेस्ट मोड एक पूरा सैंडबॉक्स है। कोई शुल्क नहीं लगता और सदस्यों को कुछ नहीं दिखता।

### क्या AI कोडिंग टूल जोड़े जा सकते हैं?

हाँ। अपने टूल को www.agilis.dating/api-doc.md या www.agilis.dating/openapi.json का पता दें।

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