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

روابط الصور الموقّعة

تصلك صور الإعلانات عبر روابط موقّعة. يشير كل رابط إلى صورة واحدة لمؤسسة واحدة، ويحمل إثباته معه، لذلك يعمل داخل وسم <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.

تحمل رسائل البريد الإلكتروني وWebhooks رابطًا أطول عمرًا بهذا الشكل:

https://api.ad80.dev/v1/creatives/<contentHash>/image?exp=<unix seconds>&org=<org>&sig=<hex>

يبقى صالحًا 7 أيام، وبعد انتهائه يرد بالرمز 410. وإن كان اشتراك Webhook مفعّلًا فيه attach_image، فإنه يحمل الصورة نفسها أيضًا داخل البيانات المرسلة، مرمّزة بـ base64 (اقرأ أحداث Webhooks).

إن احتجت الصور لمدة أطول (لأرشيف أو لملف أدلّة)، فنزّلها ما دام الرابط صالحًا واحفظها عندك.