ForHosting KIT · البيانات والملفات: تحويل وتنظيف

نسّق عنوان MAC ووحّده بصيغة النقطتين والأحرف الكبيرة

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

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

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

حوّل صيغ MAC المألوفة إلى قيمة معيارية واحدة

قد تظهر عناوين MAC بأشكال مختلفة رغم أنها تشير إلى الواجهة نفسها. فقد تعرض محطة العمل <code>a4-b1-c1-22-3d-4e</code>، ويعرض جهاز الشبكة <code>a4b1.c122.3d4e</code>، بينما يتضمن تصدير المخزون <code>A4:B1:C1:22:3D:4E</code>. تعدّ المقارنة النصية المباشرة هذه القيم مختلفة، مما قد يسبب تكرار الأصول أو فوات نتائج البحث أو إرباك تقارير المطابقة. يحذف المنسّق الفواصل المعروفة، ويتحقق من التسلسل السداسي العشري، ويحوّل الأحرف إلى كبيرة، ثم يجمع الأرقام في ستة ثمانيات من محرفين. تكون النتيجة دائماً بالشكل <code>A4:B1:C1:22:3D:4E</code>. كما يقبل اثني عشر رقماً متصلاً أو ثمانيات تفصل بينها مسافات. لا يحدد المصنّع ولا يتصل بالجهاز ولا يقرر إن كان العنوان مستخدماً. بل ينشئ قيمة ثابتة تستطيع الأنظمة الأخرى تخزينها ومقارنتها وفهرستها وعرضها بصورة متسقة.

تحقق من العنوان بدلاً من تبديل العلامات فحسب

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

استخدم الصيغة المعيارية للتخزين والمقارنة الموثوقين

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

حالات الاستخدام

تنظيف مخزون الأصول

وحّد عناوين عدة مورّدين قبل إزالة تكرار الحواسيب المحمولة ونقاط الوصول والطابعات وسائر أجهزة الشبكة.

إعداد قيم التهيئة

حوّل خرج الأجهزة المنسوخ إلى صيغة موحدة قبل إدراجه في ملف إعداد أو حمولة API.

التحقق من النماذج والواردات

ارفض السجلات التي لا تكوّن ستة ثمانيات، مع قبول أنماط الفصل الشائعة في إدخالات المستخدمين والملفات المصدّرة.

الأسئلة الشائعة

ما صيغ عناوين MAC المقبولة؟

تُقبل الصيغ المفصولة بالنقطتين أو الشرطات أو النقاط أو المسافات، وكذلك الصيغة بلا فواصل. يمكن مزج الفواصل، لكن يجب أن يبقى اثنا عشر رقماً سداسياً عشرياً.

ما صيغة النتيجة؟

تستخدم النتيجة ستة ثمانيات من رقمين بأحرف كبيرة تفصل بينها نقطتان، مثل A4:B1:C1:22:3D:4E.

هل تتحقق الأداة من وجود الجهاز؟

لا. تتحقق من البنية النصية وتوحّدها فقط؛ ولا تستعلم من الشبكة أو تتصل بالجهاز أو تؤكد تخصيص العنوان.

هل تحدد الشركة المصنّعة للجهاز؟

لا. البحث عن المصنّع خارج نطاق المنسّق، ولا يجري الوصول إلى أي قاعدة بيانات خارجية.

ماذا يحدث إذا كان الطول غير صحيح؟

يعيد الطلب خطأ إدخال غير صالح إذا لم يترك حذف الفواصل اثني عشر رقماً سداسياً عشرياً تمثل ستة ثمانيات.

كم تبلغ تكلفة الطلب؟

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

للمطوّرين — الوصول عبر API

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

الـEndpoint

POSThttps://api.kit.forhosting.com/data/mac-address-format

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

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/data/mac-address-format \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"a4-b1-c1-22-3d-4e"}'

const res = await fetch("https://api.kit.forhosting.com/data/mac-address-format", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "a4-b1-c1-22-3d-4e"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/mac-address-format",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "a4-b1-c1-22-3d-4e"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/mac-address-format", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"a4-b1-c1-22-3d-4e"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"a4-b1-c1-22-3d-4e"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/mac-address-format", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "text": "a4-b1-c1-22-3d-4e"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.mac_address_format",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

الأسعار

لكل طلب$0.002

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

الحدود

max_mb 25

الأخطاء

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

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