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

جرّب سياستك

يفحص API صفحة «جرّب سياستك» الصور التي ترسلها أنت، وهو متاح في كل الباقات. كل رفع، وكل فحص لإعلان نموذجي، وكل إعادة فحص، يستهلك فحصًا واحدًا من الفحوص اليدوية، وإن تعذّر الفحص يُعاد إليك. ويجب أن تكون للتطبيق سياسة أولًا (وإلا فالرد 400 مع write a policy for this app first).

تستخدم «جرّب سياستك» افتراضيًا تطبيق التجربة الخاص بمؤسستك (playgroundAppId من GET /v1/plan). مرّر appId لتفحص بسياسة تطبيق آخر.

{
"id": "5012",
"creativeId": "ad80px1:...",
"appId": "ad80.playground",
"width": 1080,
"height": 1920,
"imageUrl": "https://api.ad80.dev/v1/images/12/ad80px1:...?exp=...&sig=...",
"imageUrlExpiresAt": "2026-10-28T14:00:00Z",
"createdAt": "2026-10-28T13:49:02Z",
"sampleId": null,
"classifications": 2,
"job": { "id": "88123", "state": "done", "error": null },
"result": {
"decision": "violates",
"violatedRules": ["no-gambling"],
"scores": [{ "ruleId": "no-gambling", "score": 0.88, "violates": true }],
"description": "A slot machine with coins and the text ...",
"explanation": "no-gambling: slot machine and casino chips",
"policyVersion": 2,
"scoredAt": "2026-10-28T13:49:20Z"
},
"remaining": 185
}

قيمة job.state هي queued أو running أو done أو failed، ويظهر result عند done. وقيمة decision هي violates أو ok. أما remaining فهو عدد الفحوص اليدوية المتبقية لك في هذه الفترة (null = لا حدّ ثابت).

POST /v1/playground/images

النطاق write:policies. الطلب بصيغة multipart/form-data ويضم الجزء file (PNG أو JPEG أو WebP، ويُكتشف النوع من محتوى الملف نفسه)، ومعه appId إن أردت. يرد بالرمز 202 ومعه الصورة. الفحص يجري في الخلفية، فاستعلم عن GET /v1/playground/images/{id} بشكل متكرر حتى تصبح job.state هي done أو failed.

Terminal window
curl -s -X POST https://api.ad80.dev/v1/playground/images \
-H "Authorization: Bearer $AD80_API_KEY" \
-F "file=@banner.png"

الأخطاء: 400 (لا يوجد ملف، أو الملف فارغ، أو لا توجد سياسة)، و403 مع entitlement (نفد الرصيد)، و413 (الملف كبير جدًا)، و415 (ليس PNG أو JPEG أو WebP)، و422 (صورة لا يمكن استخدامها، مثل أن يكون عدد بكسلاتها كبيرًا جدًا؛ والرسالة تخبرك أي حدّ تجاوزت). حدود الحجم وعدد البكسلات قيم من الإعدادات.

إن رفعت الصورة نفسها مرة أخرى، بالمحتوى نفسه حرفيًا، يبقى معرّفها id كما هو، لكنها تُحسب فحصًا جديدًا.

GET /v1/playground/images

النطاق read:creatives. الأحدث أولًا: {"images": [ ... ], "nextCursor": "..."}، مع cursor وlimit (من 1 إلى 200، والافتراضي 50).

GET /v1/playground/images/{id}

النطاق read:creatives. صورة واحدة، ومعها result.description إن توفّر.

إعادة الفحص بالسياسة الحالية

Section titled “إعادة الفحص بالسياسة الحالية”
POST /v1/playground/images/{id}/retest

النطاق write:policies. يفحص الصورة من جديد بسياسة التطبيق الحالية. يرد بالرمز 202 ومعه الصورة. وتبقى النتيجة السابقة في سجلّك.

GET /v1/playground/samples

النطاق read:creatives. إعلانات نموذجية اخترناها لك، بعلامات تجارية متخيَّلة:

{ "samples": [ { "id": "casino-banner", "title": "...", "description": null, "width": 320, "height": 50, "imageUrl": "https://api.ad80.dev/v1/images/0/..." } ] }
POST /v1/playground/samples/{id}/classify

النطاق write:policies. جسم JSON اختياري {"appId": "..."}. يرد بالرمز 202 ومعه كائن الصورة نفسه الذي يرجعه الرفع.