ডেভেলপার ডকুমেন্টেশন

প্রতিটি অনুরোধ Authorization হেডারে Bearer স্কিম ব্যবহার করে একটি গোপন কী-এর মাধ্যমে প্রমাণীকৃত হয়।

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

যদি আপনার API কী-গুলো আপনার নিজস্ব ব্যবহারকারীদের জন্য বিজ্ঞাপনদাতার অ্যাকাউন্ট তৈরি করে (Connect মোড — উপরের Authentication দেখুন), তাহলে আপনি ওই বিজ্ঞাপনদাতারা তাদের বিজ্ঞাপনের জন্য যে অর্থ প্রদান করেন তার একটি অংশ উপার্জন করবেন। নিচের ভাগটি এই একই এন্ডপয়েন্ট থেকে সরাসরি পড়া হয়, কখনোই হার্ডকোড করা হয়নি, এবং এটি এই পৃষ্ঠার আরও নিচে থাকা রেফারেল কমিশন থেকে সম্পূর্ণ আলাদা।

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

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

এটি কীভাবে কাজ করে

1. আপনার Connect-মোড বিজ্ঞাপনদাতাদের একজন আপনার ইন্টিগ্রেশনের মাধ্যমে একটি বিজ্ঞাপনের জন্য অর্থ প্রদান করে।
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
}

প্রতি বিজ্ঞাপনদাতার অ্যাকাউন্টে অন্তর্নির্মিত এআই টুলসের একটি সেট থাকে — একটি বিজ্ঞাপন বিষয়বস্তু ও ভিজ্যুয়াল জেনারেটর, একটি কথোপকথন সহকারী, একটি বাজেট উপদেষ্টা এবং একটি বাহ্যিক SEO অডিটর — যা ফ্ল্যাট বার্ষিক মূল্যের উপরে এআই ক্রেডিট দিয়ে পরিশোধ করা হয়।

উদাহরণ — বিজ্ঞাপনের বিষয়বস্তু তৈরি করুন

একই বিভাগ এবং ব্যবসায়িক বিবরণ নীচের ইমেজ জেনারেটরকেও চালিত করে।

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
}

আপনার সাইটে একটি রেডিমেড বিজ্ঞাপন ইউনিট ড্রপ করুন — কোনো বিল্ড ধাপ নেই, কোনো আইফ্রেম নেই। স্ক্রিপ্টটি একটি বিচ্ছিন্ন শ্যাডো 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 যোগ করুন (আপনার নিজস্ব ড্যাশবোর্ডের ডেভেলপার পৃষ্ঠায় এটি খুঁজে পাবেন):

<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 ফেরত দেওয়া হয়।

প্রতি অংশীদারের জন্য ঐচ্ছিক। আপনি একটি এন্ট্রি যোগ না করা পর্যন্ত, আপনার কী-গুলো যেকোনো আইপি থেকে অনুরোধ গ্রহণ করে — প্রথম এন্ট্রি সেই অংশীদারের সব কী-কে শুধুমাত্র এলাওলিস্ট-ভিত্তিক করে তোলে।

প্রতিটি ওয়েবহুক HMAC-SHA256 দিয়ে স্বাক্ষরিত হয়, যা তৈরি করার সময় একবার ইস্যু করা একটি গোপন কী ব্যবহার করে — পেলোড বিশ্বাস করার আগে স্বাক্ষর যাচাই করুন। ইভেন্টগুলো শুধুমাত্র সেই পার্টনারকে পাঠানো হয়, যে সংশ্লিষ্ট বিজ্ঞাপনদাতার মালিক।