ForHosting KIT · التحقق من البيانات: بريد، آيبان، هواتف

قارن بصمتي تحقق لملف

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

● Betaمجاني · داخل متصفحك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

أدخل البصمة المسجلة في المصدر والبصمة المحسوبة في الوجهة باستعمال الخوارزمية نفسها. تقارن هذه الأداة القيمتين من دون التفريق بين الأحرف الكبيرة والصغيرة، وترفض القيم ذات الأطوال المختلفة، وتعيد نتيجة واضحة لا لبس فيها. وهي لا ترفع الملف ولا تفحصه ولا تحسب بصمته، لذلك تظل سيطرتكم كاملة على الملف وعلى عملية الحساب.

قارنوا قيمتي المصدر والوجهة

احسبوا بصمة تحقق للملف قبل مغادرته المصدر، ثم احسبوا بصمة أخرى بعد اكتمال النقل. يجب أن يستخدم الحسابان الخوارزمية والإعدادات نفسيهما. ألصقوا القيمة الأولى في checksum_before والثانية في checksum_after. تزيل أداة المقارنة المسافات المحيطة، وتتأكد من أن القيمتين غير فارغتين، وتتحقق من احتوائهما على العدد نفسه من المحارف. ثم تقارن السلسلتين من دون التفريق بين الأحرف الكبيرة والصغيرة. يفيد هذا السلوك مع الملخصات السداسية العشرية، إذ قد تعرض أداة الأحرف بصيغة صغيرة وتعرضها أداة أخرى بصيغة كبيرة رغم تمثيلهما للبايتات نفسها. تعني النتيجة الصحيحة أن التمثيلين متطابقان، بينما تعني النتيجة الخاطئة اختلاف محرف واحد على الأقل. تعرض النتيجة كذلك الطول المتحقق منه للمساعدة في توثيق التمثيل المقارن. ولا تستنتج الأداة الخوارزمية من الطول، لأن تنسيقات متعددة قد تتشارك الطول نفسه ولأن السلسلة وحدها لا تثبت الخوارزمية التي أنشأتها. سجّلوا اسم الخوارزمية بصورة منفصلة في إجراء النقل كي يطابق حساب الوجهة الطريقة المستعملة في المصدر بصورة موثوقة.

فسّروا التطابق من دون المبالغة في دلالته

عندما تكون النتيجة صحيحة، تكون سلسلتا بصمة التحقق متساويتين بعد توحيد حالة الأحرف. وهذا دليل قوي على أن الملف المنقول أنشأ الملخص نفسه الذي أنشأه ملف المصدر وفق الخوارزمية المختارة. لكنه لا يثبت أن هذه الصفحة حسبت أيًا من البصمتين، لأن أداة المقارنة لا تستقبل سوى السلسلتين. كما لا يمكنها اكتشاف خطأ تشغيلي إذا نُسخت القيمتان من المكان نفسه أو حُسبتا للملف الخطأ. إذا كانت النتيجة خاطئة، فأعيدوا الحسابين مباشرة على الملفين المقصودين قبل تكرار النقل. قد يدل الاختلاف على تلف أو رفع غير مكتمل أو تحويل في الوضع النصي أو أرشيف معدّل أو قيمة منسوخة من عنصر آخر. تؤدي الأطوال المختلفة إلى خطأ بدل نتيجة خاطئة، لأن القدرة تفترض صدور القيمتين عن الخوارزمية نفسها. وبموجب هذا الافتراض، يشير اختلاف الطول إلى مشكلة في الإعداد أو النسخ يجب تصحيحها. لا يُتجاهل سوى اختلاف حالة الأحرف؛ أما المسافات الداخلية وعلامات الترقيم والبادئات والفواصل فتبقى جزءًا من القيمة. لذلك استخدموا تنسيقات إخراج متوافقة أو أزيلوا الزخارف الخاصة بكل أداة قبل المقارنة.

أدرجوا المقارنة في سير عمل النقل

عند تنزيل ملف مرة واحدة، احسبوا بصمتي المصدر والوجهة بأدوات محلية موثوقة، ودوّنوا الخوارزمية بوضوح، ثم استخدموا هذه المقارنة كفحص ثانٍ. وفي التسليم الآلي، خزّنوا بصمة المصدر بجانب العنصر أو داخل بيان موقّع، واحسبوا قيمة الوجهة بعد اكتمال الكتابة النهائية، ثم استدعوا API قبل إعلان نجاح النقل. ينبغي أن يوقف عدم التطابق النشر أو التوزيع مع الاحتفاظ بسياق كافٍ للتحقيق، بينما يجب التعامل مع الزوج غير السليم أو المختلف في الطول بوصفه خطأ إعداد. اختاروا الخوارزمية وفق نموذج التهديد والموثوقية في سير العمل. تناسب دوال التجزئة التشفيرية الحديثة الحالات التي يهم فيها التلف العرضي والاستبدال المتعمد معًا؛ وقد تظل البصمات الأقدم أو الأقصر نافعة في الأنظمة المقيدة، لكنها تقدم ضمانات مختلفة. لا توصي هذه القدرة بخوارزمية ولا تفرضها، لأن مهمتها المحددة هي مقارنة قيمتين أنشأهما سير العمل مسبقًا بالطريقة نفسها. لا يستخدم الحل الحتمي شبكة أو نموذجًا أو عشوائية أو ساعة. لذلك يعيد المتصفح وAPI النتيجة نفسها للمدخلات نفسها، ويمكن للأنظمة الآلية إجراء المقارنة مقابل $0.002 لكل طلب من دون إرسال الملف الأصلي.

التحقق من إصدار مُنزّل

قارنوا بصمة التحقق المنشورة مع الإصدار بالقيمة المحسوبة بعد تنزيل ملفه.

ضبط نقل عنصر برمجي

أوقفوا التوزيع أو النشر عندما تختلف بصمة الوجهة عن قيمة المصدر المسجلة.

فحص سلامة نسخة احتياطية

قارنوا القيم المنشأة قبل نسخ البيانات الاحتياطية وبعده من دون إرسال بياناتها إلى أداة المقارنة.

هل تراعي المقارنة حالة الأحرف؟

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

لماذا تُرفض بصمات التحقق مختلفة الطول؟

يجب أن تصدر القيمتان عن الخوارزمية نفسها. يدل اختلاف الطول على تنسيقات أو خوارزميات غير متوافقة، أو على قيمة منسوخة بصورة ناقصة.

هل تحسب الأداة بصمة التحقق من ملفي؟

لا. تقارن سلسلتين تقدمونهما ولا تحتاج مطلقًا إلى استلام الملف الأصلي.

هل يثبت التطابق أن النقل آمن؟

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

هل تتجاهل الأداة المسافات؟

تُزال المسافات المحيطة بكل قيمة كاملة فقط. تظل المسافات أو الفواصل داخل القيمة ذات دلالة.

ما تكلفة المقارنة عبر API؟

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن أيضًا تشغيل المقارنة الحتمية نفسها داخل المتصفح.

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

POSThttps://api.kit.forhosting.com/verify/file-checksum-compare

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

curl -X POST https://api.kit.forhosting.com/verify/file-checksum-compare \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"checksum_before":"9e107d9d372bb6826bd81d3542a419d6","checksum_after":"9E107D9D372BB6826BD81D3542A419D6"}'
{
  "checksum_before": "9e107d9d372bb6826bd81d3542a419d6",
  "checksum_after": "9E107D9D372BB6826BD81D3542A419D6"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "verify.file_checksum_compare",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

HTTPالرمزالمعنى
401unauthorizedمفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
402insufficient_balanceرصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
404unknown_typeنوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
429rate_limitedتجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←