تخطَّ إلى المحتوى

الحوادث

تحتاج الحوادث إلى الميزة incident_management في باقتك (Enterprise). أما الباقات الأخرى فيصلها الرد 403 مع code: entitlement. تفتح AD80 حادثة تلقائيًا لكل إعلان مخالف أبلغ عنه SDK في تطبيقك (حادثة واحدة لكل إعلان وتطبيق). لا تحجب AD80 أي إعلان أبدًا، ولا تربط بإعلانات AdMob بعينها؛ فالحادثة تعطيك الأدلة ومعرّف الاستجابة في AdMob لتتحقق بنفسك.

GET /v1/incidents

النطاق read:verdicts. الأحدث أولًا.

الاستعلاممعناه
statusopen أو investigating أو resolved أو dismissed.
appهذا التطبيق فقط.
cursor, limitتقسيم النتائج إلى صفحات؛ limit من 1 إلى 200، والافتراضي 50.
Terminal window
curl -s "https://api.ad80.dev/v1/incidents?status=open" -H "Authorization: Bearer $AD80_API_KEY"
{
"incidents": [
{
"id": "77",
"creativeId": "ad80px1:...",
"appId": "com.example.news",
"status": "open",
"ruleIds": ["no-alcohol"],
"sightings": 12,
"openedAt": "2026-10-27T18:20:31Z",
"updatedAt": "2026-10-27T18:20:31Z"
}
],
"nextCursor": null
}
GET /v1/incidents/{id}

النطاق read:verdicts. الحادثة، ومعها:

الحقلمحتواه
creativeكائن الإعلان كاملًا، مع رابط صورة جديد.
notes[{ "at", "by", "text" }].
historyكل تغيير: قيمة kind هي opened أو status (مع from وto) أو note، ومعها at وby.
responseMetadata.sightingsحتى 50 من آخر مرات الظهور، الأحدث أولًا: seenAt، وadmobResponseId (أو null إن لم يُلتقط)، وnetwork، وplacement.
investigationStepsرموز خطوات التحقق اليدوي بالترتيب: copy_response_id، find_in_admob، compare_creative، block_manually، dismiss_if_acceptable. تعرضها لوحة المتابعة نصوصًا مقروءة؛ اقرأ الحوادث.
PATCH /v1/incidents/{id}

النطاق write:policies. الجسم فيه status، أو note (من 1 إلى 2000 حرف)، أو كلاهما. تستطيع الانتقال من أي حالة إلى أي حالة أخرى. كل تغيير يُضاف إلى history. ويرجع الرد تفاصيل الحادثة.

Terminal window
curl -s -X PATCH https://api.ad80.dev/v1/incidents/77 \
-H "Authorization: Bearer $AD80_API_KEY" -H "Content-Type: application/json" \
-d '{"status": "resolved", "note": "Advertiser blocked in AdMob."}'