جرّب سياستك
يفحص API صفحة «جرّب سياستك» الصور التي ترسلها أنت، وهو متاح في كل الباقات. كل رفع، وكل فحص لإعلان نموذجي، وكل إعادة
فحص، يستهلك فحصًا واحدًا من الفحوص اليدوية، وإن تعذّر الفحص يُعاد إليك. ويجب أن تكون للتطبيق سياسة
أولًا (وإلا فالرد 400 مع write a policy for this app first).
تستخدم «جرّب سياستك» افتراضيًا تطبيق التجربة الخاص بمؤسستك (playgroundAppId من
GET /v1/plan). مرّر appId لتفحص بسياسة تطبيق آخر.
كائن الصورة
Section titled “كائن الصورة”{ "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 = لا حدّ ثابت).
رفع صورة
Section titled “رفع صورة”النطاق write:policies. الطلب بصيغة multipart/form-data ويضم الجزء file (PNG أو JPEG أو WebP، ويُكتشف النوع من
محتوى الملف نفسه)، ومعه appId إن أردت. يرد بالرمز 202 ومعه الصورة. الفحص يجري في الخلفية، فاستعلم عن
GET /v1/playground/images/{id} بشكل متكرر حتى تصبح job.state هي done أو failed.
curl -s -X POST https://api.ad80.dev/v1/playground/images \ -H "Authorization: Bearer $AD80_API_KEY" \ -F "file=@banner.png"import os, time, requests
API = "https://api.ad80.dev"H = {"Authorization": f"Bearer {os.environ['AD80_API_KEY']}"}
with open("banner.png", "rb") as f: img = requests.post(f"{API}/v1/playground/images", headers=H, files={"file": f}, timeout=60).json()
while img["job"]["state"] in ("queued", "running"): time.sleep(2) img = requests.get(f"{API}/v1/playground/images/{img['id']}", headers=H, timeout=30).json()
print(img["job"]["state"], img.get("result"))import { readFile } from 'node:fs/promises';
const API = 'https://api.ad80.dev';const headers = { Authorization: `Bearer ${process.env.AD80_API_KEY}` };
const form = new FormData();form.append('file', new Blob([await readFile('banner.png')], { type: 'image/png' }), 'banner.png');let img = await (await fetch(`${API}/v1/playground/images`, { method: 'POST', headers, body: form })).json();
while (img.job.state === 'queued' || img.job.state === 'running') { await new Promise((r) => setTimeout(r, 2000)); img = await (await fetch(`${API}/v1/playground/images/${img.id}`, { headers })).json();}console.log(img.job.state, img.result);الأخطاء: 400 (لا يوجد ملف، أو الملف فارغ، أو لا توجد سياسة)، و403 مع entitlement (نفد الرصيد)، و413 (الملف كبير جدًا)، و415 (ليس PNG أو
JPEG أو WebP)، و422 (صورة لا يمكن استخدامها، مثل أن يكون عدد بكسلاتها كبيرًا جدًا؛ والرسالة تخبرك أي حدّ تجاوزت).
حدود الحجم وعدد البكسلات قيم من الإعدادات.
إن رفعت الصورة نفسها مرة أخرى، بالمحتوى نفسه حرفيًا، يبقى معرّفها id كما هو، لكنها تُحسب فحصًا جديدًا.
عرض النتائج
Section titled “عرض النتائج”النطاق read:creatives. الأحدث أولًا: {"images": [ ... ], "nextCursor": "..."}، مع cursor وlimit (من 1 إلى
200، والافتراضي 50).
قراءة نتيجة واحدة
Section titled “قراءة نتيجة واحدة”النطاق read:creatives. صورة واحدة، ومعها result.description إن توفّر.
إعادة الفحص بالسياسة الحالية
Section titled “إعادة الفحص بالسياسة الحالية”النطاق write:policies. يفحص الصورة من جديد بسياسة التطبيق الحالية. يرد بالرمز 202 ومعه الصورة. وتبقى النتيجة
السابقة في سجلّك.
الإعلانات النموذجية
Section titled “الإعلانات النموذجية”النطاق read:creatives. إعلانات نموذجية اخترناها لك، بعلامات تجارية متخيَّلة:
{ "samples": [ { "id": "casino-banner", "title": "...", "description": null, "width": 320, "height": 50, "imageUrl": "https://api.ad80.dev/v1/images/0/..." } ] }النطاق write:policies. جسم JSON اختياري {"appId": "..."}. يرد بالرمز 202 ومعه كائن الصورة نفسه الذي يرجعه الرفع.