معلومات الصورة

أداة تحليل للقراءة فقط تُرجع بيانات وصفية شاملة للصورة تشمل الأبعاد والصيغة ومساحة اللون ووجود EXIF/ICC/XMP وإحصائيات الرسم البياني لكل قناة. لا تُنتج ملف مخرجات معالجاً.

نقطة نهاية API

POST /api/v1/tools/image/info

يقبل بيانات نموذج multipart تحتوي على ملف صورة. لا حاجة لحقل إعدادات.

المعاملات

لا تحتوي هذه الأداة على معاملات قابلة للتكوين. ما عليك سوى رفع ملف الصورة.

الحقل	النوع	مطلوب	الوصف
file	file	نعم	الصورة المراد تحليلها

مثال على طلب

curl -X POST http://localhost:1349/api/v1/tools/image/info \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]"

مثال على استجابة

{
  "filename": "photo.jpg",
  "fileSize": 2450000,
  "width": 4032,
  "height": 3024,
  "format": "jpeg",
  "channels": 3,
  "hasAlpha": false,
  "colorSpace": "srgb",
  "density": 72,
  "isProgressive": false,
  "orientation": 1,
  "hasProfile": true,
  "hasExif": true,
  "hasIcc": true,
  "hasXmp": false,
  "bitDepth": "8",
  "pages": 1,
  "histogram": [
    { "channel": "red", "min": 0, "max": 255, "mean": 128.45, "stdev": 52.31 },
    { "channel": "green", "min": 2, "max": 253, "mean": 115.22, "stdev": 48.76 },
    { "channel": "blue", "min": 0, "max": 250, "mean": 102.89, "stdev": 55.14 }
  ]
}

حقول الاستجابة

الحقل	النوع	الوصف
filename	string	اسم الملف المُطهَّر
fileSize	number	حجم الملف بالبايت
width	number	عرض الصورة بالبكسل
height	number	ارتفاع الصورة بالبكسل
format	string	الصيغة المكتشفة (jpeg، png، webp، إلخ)
channels	number	عدد قنوات الألوان
hasAlpha	boolean	ما إذا كانت الصورة تحتوي على قناة alpha
colorSpace	string	مساحة اللون (srgb، cmyk، إلخ)
density	number أو null	دقة DPI/PPI
isProgressive	boolean	ما إذا كان JPEG يستخدم الترميز التدريجي
orientation	number أو null	قيمة اتجاه EXIF (1-8)
hasProfile	boolean	ما إذا كان ملف تعريف ICC مُضمّناً
hasExif	boolean	ما إذا كانت بيانات EXIF الوصفية موجودة
hasIcc	boolean	ما إذا كان ملف تعريف لون ICC موجوداً
hasXmp	boolean	ما إذا كانت بيانات XMP الوصفية موجودة
bitDepth	string أو null	البتات لكل عينة
pages	number	عدد الصفحات (للصيغ متعددة الصفحات مثل TIFF وGIF)
histogram	array	إحصائيات لكل قناة (الأدنى، الأعلى، المتوسط، الانحراف المعياري)

ملاحظات

• هذه نقطة نهاية للقراءة فقط. لا تُنتج ملف مخرجات قابلاً للتنزيل ولا jobId.
• بالنسبة لصور صيغة RAW (DNG وCR2 وNEF وARW وإلخ)، يُستخدم ExifTool لاستخراج أبعاد المستشعر الحقيقية وأعلام البيانات الوصفية التي لا يستطيع Sharp قراءتها مباشرة.
• تُفك ترميز ملفات HEIC/HEIF إلى PNG داخلياً لاستخراج إحصائيات البكسل، لأن Sharp لا يستطيع فك ترميز بكسلات HEVC.
• يوفّر الرسم البياني الأدنى/الأعلى/المتوسط/الانحراف المعياري لكل قناة، وليس توزيعاً كاملاً من 256 خانة.
• يعكس حقل density بيانات DPI الوصفية المُضمّنة، إن وُجدت.