תיעוד למפתחים

כל בקשה מאומתת באמצעות מפתח סודי בכותרת ה-Authorization, תוך שימוש בשיטת ה-Bearer.

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

אם מפתחות ה-API שלך יוצרים חשבונות מפרסמים עבור המשתמשים שלך (מצב 'Connect' — ראה 'אימות' לעיל), אתה זכאי לחלק מהסכום שהמפרסמים הללו משלמים עבור הפרסומות שלהם. החלוקה המפורטת להלן נקראת בזמן אמת מאותה נקודת קצה, אינה קבועה בקוד, והיא נפרדת לחלוטין מעמלת ההפניה המופיעה בהמשך העמוד.

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
}

גרור יחידת מודעה מוכנה לאתר שלך — ללא צורך בבנייה, ללא 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 עם מזהה השותף שלך (תוכל למצוא אותו בדף 'מפתחים' בלוח המחוונים שלך):

<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
}

תנאי התשלום

• סך הרווחים הניתנים לתשלום של המפרסם מגיע לסכום התשלום המינימלי.
• בחשבונם מוגדר ארנק לתשלומי מטבעות קריפטוגרפיים.
• סטטוס ה-KYC שלהם אומת.

דוגמה: קריאת רווחים מצטברים

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; חריגה מהמגבלה תביא לתגובה 429 Too Many Requests עם הכותרת Retry-After.

אופציונלי, לכל שותף. עד שתוסיף ערך, המפתחות שלך יקבלו בקשות מכל כתובת IP — הערך הראשון ישנה את כל המפתחות של אותו שותף כך שיפעלו אך ורק על פי רשימת ההיתרים.

כל ווב-הוק חתום באמצעות HMAC-SHA256, תוך שימוש בסוד שהונפק פעם אחת, בעת יצירתו — יש לאמת את החתימה לפני שמתחילים לסמוך על תוכן ההודעה. האירועים מועברים אך ורק לשותף שבבעלותו נמצא המפרסם הרלוונטי.