مستندات توسعهدهندگان ادزیتو
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
}