विकसक दस्तऐवजीकरण

प्रत्येक विनंती 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. तुमच्या Connect-mode जाहिरातदारांपैकी एक तुमच्या एकत्रीकरणाद्वारे जाहिरातीसाठी पैसे देतो.
2. जाहिरात पुनरावलोकन करून मंजूर केली जाते — स्वयंचलितपणे किंवा आमच्या मॉडरेशन टीमद्वारे.
3. तुमचा हिस्सा तुमच्या वॉलेटमध्ये स्वयंचलितपणे देण्यासाठी रांगेत आहे, ही खालील रेफरल प्रोग्रामप्रमाणेच कार्यप्रणाली आहे.

भुगतान अटी

• तुमच्या भागीदार खात्यावर क्रिप्टो पेआउट वॉलेट कॉन्फिगर केले गेले आहे.
• तुमच्या बाजूने कोणतीही केवायसी आवश्यक नाही — तुमचे भागीदार खाते तयार होताच आधीच तपासले गेले आहे.

उदाहरण: जमा झालेल्या शेअर्स वाचणे

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
}

प्रत्येक जाहिरातदार खात्याला अंगभूत AI साधनांचा संच मिळतो — जाहिरात सामग्री व दृश्य जनरेटर, संवादात्मक सहाय्यक, बजेट सल्लागार आणि बाह्य SEO ऑडिटर — ज्यासाठी वार्षिक निश्चित शुल्काच्या वर AI क्रेडिट्सद्वारे पैसे दिले जातात.

उदाहरण — जाहिरात सामग्री तयार करा

तीच श्रेणी आणि व्यवसाय वर्णन खालील प्रतिमा जनरेटरला देखील चालवतात.

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>

डिफॉल्टनुसार हे श्रेणीसाठीची संपूर्ण सार्वजनिक क्रमवारी दाखवते — प्लॅटफॉर्मवरील प्रत्येक जाहिरातदार, फक्त तुम्ही आणलेल्या जाहिरातदारांपुरते मर्यादित नाही. Connect मोडद्वारे तुम्ही तयार केलेल्या जाहिरातदारांच्या जाहिराती (ज्या तुमचा वाटा निर्माण करतात) फक्त दाखवण्यासाठी, तुमच्या पार्टनर आयडीसह data-partner जोडा (तुमच्या स्वतःच्या डॅशबोर्डच्या Developers पृष्ठावर तो शोधा):

<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 कडून विनंत्या स्वीकारतात — पहिली नोंद त्या भागीदाराच्या सर्व कीज फक्त परवानगी यादीतच स्वीकारण्यासाठी सेट करते.

प्रत्येक वेबहूक HMAC-SHA256 वापरून एकदाच निर्मितीच्या वेळी जारी केलेल्या गुप्त कीने स्वाक्षरी केलेले असते — पेलोडवर विश्वास ठेवण्यापूर्वी स्वाक्षरीची पडताळणी करा. इव्हेंट्स फक्त संबंधित जाहिरातदाराचा मालक असलेल्या भागीदारालाच वितरित केल्या जातात.