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

تحقق من نسب استخدام ألوان العلامة التجارية

لا تقتصر لوحة ألوان العلامة التجارية على قائمة من الألوان المعتمدة، بل تحتاج كذلك إلى توازن عملي في التصميم.

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

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

تحول هذه الأداة تغطية مساحة البكسلات المقاسة إلى نسب مئوية، ثم تقارن كل لون بالحصة المحددة في دليلكم. أدخلوا التغطية بالبكسلات أو بأي وحدة مساحة موحدة، وأضيفوا أهدافاً مثل 60 و30 و10، ثم اختاروا مقدار السماح المقبول. توضح النتيجة الألوان المطابقة، ومقدار انحراف كل لون بدقة، وما إذا كان التصميم يطابق الدليل بأكمله.

حولوا تغطية البكسلات إلى تدقيق مفيد للوحة الألوان

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

حددوا الأهداف وافهموا الانحرافات بالنقاط المئوية

أدخلوا نسبة مستهدفة لكل لون مدرج. يجب أن يكون مجموع الأهداف 100 لأنها تصف كامل المساحة المقاسة لألوان العلامة. يخصص الترتيب الشائع 60 في المئة للون السائد و30 للون الثانوي و10 للون المميز، لكن الحاسبة لا تفترض هذه القاعدة؛ فهي تدعم أي توزيع كامل بين لونين وعشرين لوناً. يعرض الانحراف بالنقاط المئوية، لا كنسبة تغير نسبية. فإذا شغل لون 14 في المئة مقابل هدف يبلغ 10، كان انحرافه موجباً بمقدار 4 نقاط مئوية. وإذا شغل 27.5 في المئة مقابل هدف يبلغ 30، كان الانحراف سالباً بمقدار 2.5 نقطة. تعني القيمة الموجبة أن اللون مستخدم أكثر من اللازم، وتعني السالبة أنه مستخدم أقل من اللازم. يحدد مقدار السماح الفروق المقبولة. فإذا كان 2، اجتازت القيم من سالب 2 إلى موجب 2 الاختبار. يحصل كل صف على حكم مستقل، ولا تتحقق مطابقة الدليل ككل إلا إذا اجتازت جميع الصفوف.

استخدموا النتيجة في مراجعة التصميم وضبط الجودة

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

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

مراجعة تكوين 60-30-10

تأكدوا من بقاء اللون السائد والثانوي ولون الإبراز ضمن مقدار السماح المتفق عليه في التصميم النهائي.

تدقيق اتساق الحملة

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

إضافة بوابة لضبط جودة التصميم

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

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

ما وحدة التغطية التي ينبغي استخدامها؟

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

هل يجب أن يكون مجموع النسب المستهدفة 100؟

نعم. تمثل الأهداف التوزيع الكامل للمساحة المقاسة لألوان العلامة، ولذلك يجب أن يكون مجموعها 100.

ماذا يعني مقدار السماح؟

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

هل تستخرج هذه الأداة الألوان من صورة؟

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

ماذا يحدث إذا كانت جميع قيم التغطية صفراً؟

يعيد الطلب خطأ إدخال غير صالح، إذ لا يمكن حساب النسب المئوية انطلاقاً من مجموع غير موجب.

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

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/brand-color-usage-ratio-check

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

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

curl -X POST https://api.kit.forhosting.com/date/brand-color-usage-ratio-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"colors":[{"color":"Primary blue","coverage":60000,"target_percentage":60},{"color":"Secondary gray","coverage":30000,"target_percentage":30},{"color":"Accent orange","coverage":10000,"target_percentage":10}]}'

const res = await fetch("https://api.kit.forhosting.com/date/brand-color-usage-ratio-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "colors": [
      {
        "color": "Primary blue",
        "coverage": 60000,
        "target_percentage": 60
      },
      {
        "color": "Secondary gray",
        "coverage": 30000,
        "target_percentage": 30
      },
      {
        "color": "Accent orange",
        "coverage": 10000,
        "target_percentage": 10
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/brand-color-usage-ratio-check",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "colors": [
        {
            "color": "Primary blue",
            "coverage": 60000,
            "target_percentage": 60
        },
        {
            "color": "Secondary gray",
            "coverage": 30000,
            "target_percentage": 30
        },
        {
            "color": "Accent orange",
            "coverage": 10000,
            "target_percentage": 10
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/brand-color-usage-ratio-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"colors":[{"color":"Primary blue","coverage":60000,"target_percentage":60},{"color":"Secondary gray","coverage":30000,"target_percentage":30},{"color":"Accent orange","coverage":10000,"target_percentage":10}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"colors":[{"color":"Primary blue","coverage":60000,"target_percentage":60},{"color":"Secondary gray","coverage":30000,"target_percentage":30},{"color":"Accent orange","coverage":10000,"target_percentage":10}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/brand-color-usage-ratio-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "colors": [
    {
      "color": "Primary blue",
      "coverage": 60000,
      "target_percentage": 60
    },
    {
      "color": "Secondary gray",
      "coverage": 30000,
      "target_percentage": 30
    },
    {
      "color": "Accent orange",
      "coverage": 10000,
      "target_percentage": 10
    }
  ]
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.brand_color_usage_ratio_check",
  "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 الكامل ←