ForHosting KIT · أدوات المطورين

التحقق من لون سداسي عشري

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

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

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

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

تقبل الصيغ القياسية ذات 3 أو 4 أو 6 أو 8 خانات، سواء بدأت بعلامة # أم لم تبدأ بها، وتفحص كل محرف من دون تخمين القيمة أو تصحيحها. تأتي النتيجة كقيمة منطقية بسيطة يسهل استعمالها في النماذج والاختبارات وعمليات الاستيراد ومسارات API. أما الحقول المفقودة وأنواع البيانات غير الصحيحة فتنتج أخطاء واضحة، وبذلك لا تختلط مشكلة في بنية الطلب بلون غير صالح ضمن طلب سليم.

متى يكون اللون السداسي صالحا

يتكون اللون السداسي الصالح من 3 أو 4 أو 6 أو 8 خانات سداسية عشرية بالضبط. تمثل 3 خانات صيغة RGB المختصرة، وتمثل 4 خانات صيغة RGBA المختصرة مع قناة ألفا، بينما تمثل 6 خانات RGB الكامل و8 خانات RGBA الكامل. علامة # في البداية اختيارية، لأن CSS وقواعد البيانات وأدوات التصميم وملفات الإعداد لا تخزن هذه السابقة دائما بالطريقة نفسها. بعد السابقة الاختيارية، يجب أن يكون كل محرف رقما من ASCII بين 0 و9 أو حرفا من A إلى F، وتقبل الأحرف الكبيرة والصغيرة. لا يقبل الفاحص المسافات أو علامات الترقيم أو الإشارات أو تكرار # أو أسماء الألوان أو دوال CSS أو أي طول آخر. كما أنه لا يحذف المسافات من المدخل. تكشف هذه الصرامة المسافات الخفية وتمنع اعتماد قيمة تختلف عن المصدر المخزن من دون تنبيه. لذلك تصف القيمة المنطقية <code>valid</code> السلسلة التي تقدمونها كما هي تماما.

فائدة التحقق الحتمي

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

استخدام النتيجة في النماذج ومسارات المعالجة

استخدموا الفاحص قبل أن تتجاوز قيمة اللون حدود الثقة مباشرة. في النموذج، شغلوه عند تغير الحقل أو قبل الإرسال، ثم اعرضوا رسالة محددة عندما تكون <code>valid</code> غير صحيحة. وفي استيراد رموز التصميم، افحصوا كل قيمة قبل توليد CSS حتى لا يؤدي رمز مشوه إلى إبطال ورقة الأنماط أو الانتشار في السمة. احتفظوا في مسار البيانات بالسلسلة الأصلية إلى جانب القيمة المنطقية إذا احتجتم إلى سجل تدقيق، ولا تستبدلوا المصدر بقيمة مطبّعة لأن هذه القدرة تتحقق ولا تحول. إذا احتجتم إلى التوسيع أو التحويل أو استخراج القنوات، فتحققوا أولا ثم مرروا القيم المقبولة إلى قدرة الألوان المناسبة. يناسب التنفيذ في المتصفح الفحوص التفاعلية، ويمكن للعمليات المؤتمتة استعمال API بسعر $0.002 لكل طلب. تدخل النتيجة المستقرة مباشرة في الشروط واختبارات الأطوال والمحارف غير الصالحة والسوابق الزائدة والسلاسل الفارغة والمسافات.

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

فحص حقل لون

تأكدوا من أن المستخدم قدم صيغة RGB أو RGBA مسموحا بها قبل حفظ تفضيل السمة.

التحقق من رموز التصميم

ارفضوا الألوان المشوهة قبل تحويل مجموعة الرموز إلى متغيرات CSS أو ثوابت التطبيق.

حماية الأنماط المولدة

افحصوا سلاسل الألوان الخارجية قبل إدراجها في ورقة أنماط أو إعداد مكوّن.

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

ما الأطوال الصالحة؟

3 أو 4 أو 6 أو 8 خانات سداسية عشرية بالضبط، من دون احتساب علامة # الاختيارية في البداية.

هل علامة # في البداية مطلوبة؟

لا. تعد #336699 و336699 تمثيلين صالحين لدى هذا الفاحص.

هل تقبل الأحرف الكبيرة؟

نعم. تقبل الأحرف السداسية عشرية من A إلى F بحالتها الكبيرة أو الصغيرة.

هل يحذف الفاحص المسافات؟

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

ما تكلفة الاستخدام؟

سعر API هو $0.002 لكل طلب، ويمكن تشغيل الفحص الحتمي نفسه في متصفحكم.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/color/is-valid-hex

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

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

curl -X POST https://api.kit.forhosting.com/color/is-valid-hex \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"#336699cc"}'

const res = await fetch("https://api.kit.forhosting.com/color/is-valid-hex", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "#336699cc"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/color/is-valid-hex",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "#336699cc"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/is-valid-hex", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"#336699cc"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"#336699cc"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/is-valid-hex", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "text": "#336699cc"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

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