الحساب والباقة
من أنا
Section titled “من أنا”يعمل مع أي مفتاح صالح. يرجع المؤسسة والباقة ونطاقات المفتاح. يكون user وrole بقيمة null مع مفتاح API
(ولهما قيمة في جلسات لوحة المتابعة).
curl -s https://api.ad80.dev/v1/me -H "Authorization: Bearer $AD80_API_KEY"{ "org": { "id": "12", "name": "Example Media" }, "plan": "starter", "scopes": ["read:creatives", "read:verdicts"], "user": null, "role": null}معرفة باقتك
Section titled “معرفة باقتك”النطاق read:creatives. يرجع باقتك، وما تشمله، واستهلاك الفترة الحالية. عدّادات الاستهلاك شهرية حسب التقويم
(بتوقيت UTC). وفي كل حدّ، null تعني أنه لا يوجد حدّ ثابت، و0 تعني أن الباقة لا تشمله.
curl -s https://api.ad80.dev/v1/plan -H "Authorization: Bearer $AD80_API_KEY"import os, requests
plan = requests.get("https://api.ad80.dev/v1/plan", headers={"Authorization": f"Bearer {os.environ['AD80_API_KEY']}"}, timeout=30).json()imp = plan["usage"]["monitoredImpressions"]print(plan["plan"], "impressions used:", imp["used"], "of", imp["limit"])const res = await fetch('https://api.ad80.dev/v1/plan', { headers: { Authorization: `Bearer ${process.env.AD80_API_KEY}` },});const plan = await res.json();console.log(plan.plan, plan.usage.monitoredImpressions);الرد (الأرقام للتوضيح فقط):
{ "plan": "starter", "name": "Starter", "price": { "display": "..." }, "playgroundAppId": "ad80.playground", "policyLimits": { "maxRules": 20, "maxRuleChars": 500 }, "entitlements": { "maxActivePolicies": 10, "manualClassificationsPerMonth": 200, "monitoredImpressionsPerMonth": 3000, "expeditedNotificationsPerMonth": 10, "notificationChannels": ["email", "webhook"], "reporting": "basic", "investigationTools": "basic", "support": "standard", "sdkIngestEnabled": true, "incidentManagement": false }, "usage": { "periodStart": "2026-10-01T00:00:00Z", "periodEnd": "2026-11-01T00:00:00Z", "activePolicies": { "used": 2, "limit": 10, "remaining": 8 }, "manualClassifications": { "used": 14, "limit": 200, "remaining": 186 }, "monitoredImpressions": { "used": 1250, "limit": 3000, "remaining": 1750 }, "expeditedNotifications": { "used": 3, "limit": 10, "remaining": 7 }, "notClassifiedImpressions": 0 }, "upgrade": { "target": "enterprise", "contact": "mailto:contact@ad80.dev" }}| الحقل | معناه |
|---|---|
plan | free أو starter أو enterprise. |
playgroundAppId | التطبيق الذي تستخدمه صفحة «جرّب سياستك». تنشئه AD80 لك. |
policyLimits | الحدود البنيوية للسياسة (عدد القواعد في السياسة، وعدد الأحرف في القاعدة)، وهي واحدة في كل الباقات. |
entitlements | ما تشمله الباقة. reporting: none أو basic أو advanced. investigationTools: none أو basic أو incident_management. support: community أو standard أو priority. |
usage | عدّادات الفترة الحالية: used وlimit وremaining (null = لا حدّ ثابت). يعدّ notClassifiedImpressions مرات الظهور التي لم تُفحص لأن الرصيد نفد. |
upgrade.target | الباقة الأعلى التالية، أو null إن كنت على أعلى باقة. الترقية تتم بالتواصل مع AD80، فلا يوجد API للدفع. |
أرقام النظرة العامة
Section titled “أرقام النظرة العامة”النطاق read:creatives. الأرقام التي تقوم عليها صفحة نظرة عامة في لوحة المتابعة، في طلب واحد.
curl -s https://api.ad80.dev/v1/overview -H "Authorization: Bearer $AD80_API_KEY"{ "violationsToday": 3, "violations7d": 17, "unreviewed": 9, "daily": [{ "date": "2026-10-22", "violations": 2, "creatives": 40 }], "topNetworks": [{ "network": "meta", "violations": 6 }], "usage": { "periodStart": "2026-10-01T00:00:00Z", "periodEnd": "2026-11-01T00:00:00Z", "...": "same as /v1/plan" }, "sdkHealth": [{ "appId": "com.example.news", "name": "com.example.news", "lastUploadAt": "2026-10-28T09:12:44Z" }]}يغطي daily آخر 7 أيام بتوقيت UTC، من الأقدم إلى الأحدث. ويعرض sdkHealth تطبيقاتك التي تستخدم SDK (دون
تطبيق «جرّب سياستك») مع آخر رفع مقبول لكل منها.