AAquaSearch Adsבטא · ads.aquasearch.ai
מ

פורטל למפתחים

ניהול מפתחות API, צריכת מכסה, OAuth, webhooks, ו-SDK-ים.
OpenAPI Spec

מפתחות API

מפתחות חיים מוצגים פעם אחת בלבד עם יצירתם. ניתן לסבב בכל עת.

מפתח ראשי (production)
sk_live_••••••••••••••2041
נוצר 12/04/2026 · שימוש אחרון לפני 4 דק׳
פעיל
מפתח בדיקות (sandbox)
sk_test_••••••••••••••8821
נוצר 01/03/2026 · ללא שימוש 30 יום
בדיקות

מכסת חודש

חבילת Pro · 10,000 קריאות.

41%
4,120 מתוך 10,000 קריאות החודש.
התראה תופעל אוטומטית כשתחצה 80%.

דוגמת קוד — יצירת קמפיין

Bash / cURL. SDK-ים זמינים ל-Node, Python, ו-PHP.

POST /v1/campaigns
curl -X POST https://api.aquasearch.ai/v1/campaigns \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "משאבות Pedrollo · גוש דן",
    "objective": "leads",
    "daily_budget": 120.00,
    "bid_strategy": "auto_max_leads",
    "start_date": "2026-06-01"
  }'

מגבלות קריאה (Rate Limits)

תגובת 429 כוללת Retry-After.

חבילהמכסה לדקהburst
Free60 / דקה5 / שניה
Pro300 / דקה25 / שניה
Enterprise2,000 / דקה200 / שניה

הרשאות OAuth 2.0

Authorization Code Flow · access token 1 שעה · refresh 30 ימים.

ads:read

קריאת קמפיינים, קבוצות, מודעות, ביצועים.

ads:write

יצירה ועריכה של קמפיינים, קבוצות, מודעות, ביידים.

conversions:write

שליחת אירועי המרה (server-side).

reports:read

קריאת דוחות ואנליטיקס.

Webhooks

קבל אירועים בזמן אמת: campaign.created, ad.approved, conversion.received, wallet.low, ועוד 8 אירועים. חתימת HMAC על כל בקשה, 5 ניסיונות חוזרים עם exponential backoff.

עדיין לא הוגדר. הוסף נקודת קצה כדי להתחיל לקבל אירועים.