ادزیتو
مدیریت کلیدها

مستندات توسعه‌دهندگان ادزیتو

API ادزیتو

تبلیغات، آمار و کیف پول فضای کاری را از سرویس خود مدیریت کنید. پاسخ‌ها JSON و همهٔ مبلغ‌ها به تومان هستند.

احراز هویت

کلید را در داشبورد بسازید، IP سرور را در فهرست مجاز قرار دهید و آن را با Bearer بفرستید.

Authorization: Bearer adsito_live_…

آدرس پایه

https://adsito.online/api/v1

خطاها

Problem Details با کد پایدار و traceId

سرویس تبلیغات

3

ساخت، مشاهده و مدیریت تبلیغات فضای کاری.

GETفهرست تبلیغات/ads

فهرست صفحه‌بندی‌شدهٔ تبلیغات فضای کاری را برمی‌گرداند.

پارامترها

pageاختیاریinteger

شماره صفحه؛ پیش‌فرض ۱

pageSizeاختیاریinteger

تعداد نتیجه در هر صفحه

statusاختیاریAdStatus

فیلتر اختیاری وضعیت

درخواست cURL

curl 'https://adsito.online/api/v1/ads?page=1&pageSize=20' \
  -H 'Authorization: Bearer <api_key>'

پاسخ نمونه

{
  "items": [{
    "id": "019a...",
    "number": "AD-1405-0012",
    "title": "کمپین پاییز",
    "status": "Active",
    "views": 18420,
    "clicks": 613,
    "spentToman": 920000
  }],
  "page": 1,
  "pageSize": 20,
  "total": 1
}
POSTساخت پیش‌نویس/ads

یک پیش‌نویس تبلیغ می‌سازد. مالک و مدیر فضای کاری مجازند.

پارامترها

targetTypeالزامیAdTargetType

نوع هدف‌گیری: Channels، Bots، Search یا Users

titleاختیاریstring

نام داخلی تبلیغ

درخواست cURL

curl -X POST 'https://adsito.online/api/v1/ads' \
  -H 'Authorization: Bearer <api_key>' \
  -H 'Content-Type: application/json' \
  -d '{"targetType":"Channels","title":"کمپین پاییز"}'

پاسخ نمونه

{
  "id": "019a...",
  "number": "AD-1405-0012",
  "title": "کمپین پاییز",
  "targetType": "Channels",
  "status": "Draft"
}
GETجزئیات تبلیغ/ads/{id}

جزئیات، بودجه‌ها، آمار و بازبینی‌های یک تبلیغ را می‌خواند.

پارامترها

idالزامیuuid

شناسه تبلیغ در مسیر

درخواست cURL

curl 'https://adsito.online/api/v1/ads/<ad_id>' \
  -H 'Authorization: Bearer <api_key>'

پاسخ نمونه

{
  "id": "019a...",
  "status": "Active",
  "budgetToman": 2500000,
  "remainingToman": 1580000,
  "views": 18420,
  "clicks": 613
}

سرویس آمار

2

آمار تحویل و عملکرد فضای کاری و تبلیغات.

GETنمای کلی آمار/stats/overview

مجموع آمار و سری روزانه را در بازهٔ تقویم تهران برمی‌گرداند.

پارامترها

fromاختیاریdate

ابتدای بازه با قالب yyyy-MM-dd

toاختیاریdate

انتهای بازه با قالب yyyy-MM-dd

درخواست cURL

curl 'https://adsito.online/api/v1/stats/overview?from=2026-10-01&to=2026-10-11' \
  -H 'Authorization: Bearer <api_key>'

پاسخ نمونه

{
  "from": "2026-10-01",
  "to": "2026-10-11",
  "total": { "views": 18420, "clicks": 613, "spentToman": 920000 },
  "activeAds": 2,
  "daily": []
}
GETبرترین تبلیغات/stats/top-ads

تبلیغ‌های با بیشترین هزینه در بازه را رتبه‌بندی می‌کند.

پارامترها

limitاختیاریinteger

بین ۱ تا ۲۰؛ پیش‌فرض ۵

درخواست cURL

curl 'https://adsito.online/api/v1/stats/top-ads?limit=5' \
  -H 'Authorization: Bearer <api_key>'

پاسخ نمونه

{
  "from": "2026-09-12",
  "to": "2026-10-11",
  "items": []
}

سرویس کیف پول

2

موجودی و گردش مالی فضای کاری به تومان.

GETموجودی کیف پول/wallet

موجودی کل، رزروشده و قابل استفاده را می‌خواند.

درخواست cURL

curl 'https://adsito.online/api/v1/wallet' \
  -H 'Authorization: Bearer <api_key>'

پاسخ نمونه

{
  "balance": 6400000,
  "held": 1580000,
  "available": 4820000
}
GETگردش حساب/wallet/ledger

رویدادهای مالی را به‌ترتیب جدیدترین مورد برمی‌گرداند.

پارامترها

pageاختیاریinteger

شماره صفحه

typeاختیاریLedgerEntryType

فیلتر اختیاری نوع رویداد

درخواست cURL

curl 'https://adsito.online/api/v1/wallet/ledger?page=1' \
  -H 'Authorization: Bearer <api_key>'

پاسخ نمونه

{
  "items": [],
  "page": 1,
  "pageSize": 20,
  "total": 0
}