डेवलपर दस्तावेज़ीकरण

हर अनुरोध को Authorization हेडर में Bearer स्कीम का उपयोग करके एक गुप्त कुंजी के साथ प्रमाणीकृत किया जाता है।

POST https://api.adhub365.com/v1/partner/ads
Authorization: Bearer sk_sandbox_...
Content-Type: application/json

यदि आपकी API कुंजियाँ आपके स्वयं के उपयोगकर्ताओं के लिए विज्ञापनदाता खाते बनाती हैं (कनेक्ट मोड — ऊपर प्रमाणीकरण देखें), तो आप उन विज्ञापनदाताओं द्वारा अपने विज्ञापनों के लिए किए गए भुगतान का एक हिस्सा अर्जित करते हैं। नीचे दिया गया विभाजन इसी एंडपॉइंट से लाइव पढ़ा जाता है, कभी भी हार्डकोड नहीं किया जाता, और यह इस पृष्ठ पर आगे दिए गए रेफ़रल कमीशन से पूरी तरह से अलग है।

GET https://api.adhub365.com/v1/partner-program

{
  "partner_share_percentage": 0.7,
  "platform_share_percentage": 0.3
}

यह कैसे काम करता है

1. आपके कनेक्ट-मोड विज्ञापनदाताओं में से एक आपके इंटीग्रेशन के माध्यम से एक विज्ञापन के लिए भुगतान करता है।
2. विज्ञापन की समीक्षा की जाती है और इसे मंजूरी दी जाती है — स्वचालित रूप से, या हमारी मॉडरेशन टीम द्वारा।
3. आपका हिस्सा आपके वॉलेट में स्वचालित भुगतान के लिए कतारबद्ध है, यह नीचे दिए गए रेफ़रल प्रोग्राम की ही प्रक्रिया है।

भुगतान की शर्तें

• आपके पार्टनर खाते पर एक क्रिप्टो भुगतान वॉलेट कॉन्फ़िगर किया गया है।
• आपकी ओर से कोई KYC आवश्यक नहीं है — आपके पार्टनर खाते की सत्यापना पहले ही निर्माण के समय हो चुकी है।

उदाहरण: संचित शेयरों को पढ़ना

GET https://api.adhub365.com/v1/partner/ad-revenue/earnings
Authorization: Bearer sk_sandbox_...

{
  "shares": [
    {
      "id": "share_1a2b...",
      "payment_id": "pay_9f2a...",
      "ad_id": "ad_7c31...",
      "partner_amount_usd": 140.0,
      "platform_amount_usd": 60.0,
      "status": "paid",
      "payable_after": "2026-08-03T00:00:00Z",
      "paid_at": "2026-08-05T10:12:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 140.0
}

हर विज्ञापनदाता खाते को अंतर्निहित एआई टूल्स का एक सेट मिलता है — एक विज्ञापन सामग्री और दृश्य जनरेटर, एक संवादात्मक सहायक, एक बजट सलाहकार, और एक बाहरी एसईओ ऑडिटर — जो फ्लैट वार्षिक मूल्य के ऊपर एआई क्रेडिट्स से भुगतान किए जाते हैं।

उदाहरण — विज्ञापन सामग्री उत्पन्न करें

उसी श्रेणी और व्यवसाय विवरण से नीचे दिए गए इमेज जनरेटर को भी शक्ति मिलती है।

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "title": "Handmade Oak Dining Tables — Built to Last",
  "description": "Solid oak dining tables crafted by hand, built to last a lifetime.",
  "keywords": ["oak furniture", "dining table", "handmade"],
  "credits_remaining": 8
}

उसी विज्ञापन के लिए एक मेल खाने वाला दृश्य उत्पन्न करें:

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio/image
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "visual_url": "https://cdn.uploadscenter.com/file_01m1...",
  "credits_remaining": 4
}

अपनी साइट पर एक तैयार विज्ञापन यूनिट ड्रॉप करें — कोई बिल्ड स्टेप नहीं, कोई iframe नहीं। स्क्रिप्ट एक अलग Shadow DOM के भीतर सीधे पेज में रेंडर होती है, इसलिए इसकी शैलियाँ कभी आपकी साइट में नहीं लीक होतीं, और आपकी साइट की शैलियाँ कभी इसमें नहीं लीक होतीं।

इसे अपने पेज में जोड़ें

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>
<script async src="https://adhub365.com/widget.js"></script>

डिफ़ॉल्ट रूप से यह श्रेणी के लिए पूरी सार्वजनिक रैंकिंग दिखाता है — प्लेटफ़ॉर्म पर हर विज्ञापनदाता, न कि केवल वे जिन्हें आपने लाया है। केवल उन विज्ञापनदाताओं के विज्ञापन दिखाने के लिए जिन्हें आपने कनेक्ट मोड के माध्यम से बनाया है (जो आपका हिस्सा उत्पन्न कर रहे हैं), data-partner में अपनी पार्टनर आईडी जोड़ें (इसे अपने डैशबोर्ड के डेवलपर्स पेज पर खोजें):

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

यदि आपके विज्ञापनदाता कई श्रेणियों में फैले हुए हैं, तो data-category को पूरी तरह से हटा दें — केवल data-partner के साथ, विजेट सभी श्रेणियों में आपके प्रत्येक विज्ञापन को एक ही ग्रिड में दिखाता है, बजाय इसके कि प्रत्येक श्रेणी के लिए एक विजेट ब्लॉक की आवश्यकता हो:

<div
  class="annualads-widget"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

क्या आप अपनी इन-कंटेंट यूनिट के साथ एक फुटर-स्टाइल यूनिट भी चाहते हैं, जो अलग-अलग विज्ञापन दिखाए? एक दूसरा विजेट ब्लॉक जोड़ें जिसमें data-layout="compact" (एक विज्ञापन, जिसे छोटे पिल में संकुचित किया जा सकता है) हो और data-offset को इस आधार पर सेट करें कि आपकी पहली विजेट पहले से कितने विज्ञापन दिखा रही है:

<!-- in your content -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>

<!-- in your footer, showing different ads via data-offset -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-layout="compact"
  data-offset="4"
></div>
<script async src="https://adhub365.com/widget.js"></script>

विशेषताएँ

एक पार्टनर का रेफ़रल कमीशन वास्तव में उन्हें कैसे मिलता है — प्रतिशत, भुगतान की प्रक्रिया, और पूर्व शर्तें।

GET https://api.adhub365.com/v1/referral-program

{
  "levels": [
    {
      "level": 1,
      "percentage": 0.1
    }
  ],
  "leaders_pool_percentage_of_gmv": 0.05,
  "founding_advertiser_pool_percentage_of_gmv": 0.05,
  "payout_verification_window_hours": 48,
  "min_payout_usd": 1
}

भुगतान की शर्तें

• विज्ञापनदाता की कुल देय आय न्यूनतम भुगतान राशि तक पहुँच जाती है।
• उनके खाते पर एक क्रिप्टो भुगतान वॉलेट कॉन्फ़िगर किया गया है।
• उनका केवाईसी सत्यापित है।

उदाहरण: संचित आय पढ़ना

GET https://api.adhub365.com/v1/partner/referrals/{code}/earnings
Authorization: Bearer sk_sandbox_...

{
  "code": "ann-2f8c",
  "earnings": [
    {
      "id": "earn_1a2b...",
      "payment_id": "pay_9f2a...",
      "amount_usd": 30.0,
      "status": "paid",
      "payable_after": "2026-08-01T00:00:00Z",
      "paid_at": "2026-08-03T14:22:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 30.0
}

मूल्य निर्धारण स्तर (लाइव)

इस एंडपॉइंट से लाइव पढ़ें — इन मानों को कभी भी हार्डकोड न करें, ये हमारी ओर से बदल सकते हैं। नि:शुल्क राशि फ़ील्ड के बजाय अपने उपयोगकर्ताओं के लिए एक स्तर चयनकर्ता बनाएँ: दिखाया गया प्रत्येक मूल्य भुगतान बनाते समय भेजने के लिए सटीक राशि होता है, और यहाँ दिखाए गए अनलॉक किए गए लाभ उपयोगकर्ताओं को ठीक-ठीक बताते हैं कि उस मूल्य से उन्हें क्या मिलता है, ताकि वे अनुमान लगाने के बजाय एक ऐसा मूल्य चुनें जिसे वे समझते हैं।

प्रत्येक कुंजी के लिए प्रति मिनट अनुरोधों की संख्या सीमित है। प्रत्येक प्रमाणीकृत प्रतिक्रिया में X-RateLimit-Limit, X-RateLimit-Remaining और X-RateLimit-Reset हेडर होते हैं; सीमा पार करने पर Retry-After हेडर के साथ 429 Too Many Requests लौटाया जाता है।

वैकल्पिक, प्रति साझेदार। जब तक आप कोई प्रविष्टि नहीं जोड़ते, आपकी कुंजियाँ किसी भी IP से अनुरोध स्वीकार करती हैं — पहली प्रविष्टि उस साझेदार की सभी कुंजियों को केवल अनुमोदित सूचियों (allowlist-only) में बदल देती है।

प्रत्येक वेबहुक को एक बार जारी किए गए गुप्त कुंजी का उपयोग करके HMAC-SHA256 से हस्ताक्षरित किया जाता है — पेलोड पर भरोसा करने से पहले हस्ताक्षर की पुष्टि करें। इवेंट्स केवल उस पार्टनर को भेजे जाते हैं जो संबंधित विज्ञापनदाता का मालिक है।