روابط الصور الموقّعة
تصلك صور الإعلانات عبر روابط موقّعة. يشير كل رابط إلى صورة واحدة لمؤسسة واحدة، ويحمل إثباته معه، لذلك يعمل
داخل وسم <img> أو عند التنزيل دون مفتاح API. تعامل مع الرابط كأنه سرّ قصير العمر: من يملكه يستطيع فتح
الصورة إلى أن تنتهي صلاحيته.
الروابط في ردود الواجهة
Section titled “الروابط في ردود الواجهة”يبدو imageUrl في الإعلانات وصور «جرّب سياستك» والحوادث هكذا:
https://api.ad80.dev/v1/images/<org>/<contentHash>?exp=<unix seconds>&sig=<hex>- تنتهي صلاحيته بعد 10 دقائق من إنشاء الرد، ويخبرك
imageUrlExpiresAtبالموعد بالضبط. - بعدها يرد بالرمز 403 (
image link expired). اطلب الإعلان من جديد لتحصل على رابط جديد. - الصورة بصيغة PNG (
Content-Type: image/png). ويسمح الرد بالاستخدام من نطاقات أخرى، فتستطيع عرضها في صفحاتك. - الرابط الذي عُدّل توقيعه يرد بالرمز 403، والرابط لصورة لا تملكها مؤسستك يرد بالرمز 404.
الروابط في الإشعارات
Section titled “الروابط في الإشعارات”تحمل رسائل البريد الإلكتروني وWebhooks رابطًا أطول عمرًا بهذا الشكل:
https://api.ad80.dev/v1/creatives/<contentHash>/image?exp=<unix seconds>&org=<org>&sig=<hex>يبقى صالحًا 7 أيام، وبعد انتهائه يرد بالرمز 410. وإن كان اشتراك Webhook مفعّلًا فيه attach_image، فإنه
يحمل الصورة نفسها أيضًا داخل البيانات المرسلة، مرمّزة بـ base64 (اقرأ أحداث Webhooks).
الاحتفاظ بالصور
Section titled “الاحتفاظ بالصور”إن احتجت الصور لمدة أطول (لأرشيف أو لملف أدلّة)، فنزّلها ما دام الرابط صالحًا واحفظها عندك.