ForHosting KIT · المستندات وملفات PDF

حساب إصدار رمز QR المطلوب حسب السعة وتصحيح الأخطاء

تحدد حاسبة إصدار رمز QR هذه أصغر رمز يستطيع استيعاب عدد معين من البايتات عند مستوى تصحيح الأخطاء L أو M أو Q أو H.

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

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

وتعتمد حدود السعة القياسية لنمط البايت في إصدارات QR من 1 إلى 40، ثم تعرض الإصدار المختار وعدد الوحدات في كل ضلع والسعة المتاحة والبايتات المتبقية. تساعدكم النتيجة على تحديد حجم الرمز قبل إعداد التصميم، واختيار أبعاد الطباعة، ومعرفة ما إذا كان تصحيح الأخطاء الأقوى سيجعل الرمز شديد الكثافة.

ابدؤوا بطول البيانات المشفرة بالبايت

تعتمد سعة رمز QR على نمط الترميز، لا على عدد المحارف الظاهرة وحده. تستخدم هذه الحاسبة نمط البايت عمداً لأنه خيار عام موثوق لعناوين URL والنصوص والمعرفات وعلامات الترقيم المتنوعة. أدخلوا عدد البايتات التي تشغلها الحمولة النهائية بعد ترميز النص. يستهلك محرف ASCII البسيط عادة بايتاً واحداً، بينما تحتاج الحروف ذات العلامات والرموز التعبيرية وكثير من أنظمة الكتابة غير اللاتينية إلى أكثر من بايت في UTF-8. قد يؤدي عد المحارف الظاهرة فقط إلى اختيار إصدار أصغر من المطلوب. احسبوا كل ما سيُرمز فعلياً، بما في ذلك معاملات الاستعلام في URL والفواصل وفواصل الأسطر وبادئات البيانات المنظمة. تعرض النتيجة أول إصدار QR تبلغ سعته في نمط البايت ذلك الطول أو تتجاوزه. كما تعرض البايتات المتبقية، وهي هامش مفيد إذا كانت الحمولة قد تزيد قبل الإنتاج. لا يحول هذا التقدير البيانات الرقمية أو الأبجدية الرقمية إلى أنماط QR الأكثر اختصاراً، ولذلك قد ينجح برنامج ترميز متخصص في وضع البيانات المؤهلة داخل رمز أصغر.

اختاروا مستوى تصحيح الأخطاء بعناية

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

افهموا الإصدار وأبعاد الوحدات

تمتد إصدارات QR من 1 إلى 40. يتكون الإصدار 1 من 21 وحدة في كل ضلع، ويضيف كل إصدار لاحق أربع وحدات إلى كل ضلع. لذلك يصف عدد الوحدات المعروض شبكة البيانات المربعة، لا الحجم النهائي بالمليمترات أو وحدات البكسل. لا يزال على مولد الرمز إضافة المنطقة الهادئة، التي يكون عرضها عادة أربع وحدات عند كل حافة، كما يجب أن يكون الحجم الفعلي لكل وحدة مناسباً للكاميرا ومسافة القراءة المستهدفة. الإصدار الأدنى نتيجة تتعلق بالسعة، وليس ضماناً شاملاً لجودة المسح. قد تختلف نتيجة برنامج الترميز الفعلي إذا انتقل تلقائياً بين المقاطع الرقمية والأبجدية الرقمية ونمط البايت وKanji، أو أضاف مؤشراً صريحاً لمجموعة المحارف، أو استخدم سلوكاً خاصاً للتقسيم المنظم. تعاملوا مع النتيجة بوصفها تقديراً محافظاً لنمط البايت، واختبروا الرمز النهائي باستخدام الحمولة وبرنامج الترميز اللذين ستنشرونهما. إذا رفضت الحاسبة الإدخال، فلن يستوعب الإصدار 40 هذا العدد من البايتات عند المستوى المختار؛ اختصروا الحمولة أو اخفضوا مستوى التصحيح أو رمزوا مرجعاً موجزاً.

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

تخطيط الملصقات المطبوعة

قدّروا كثافة الرمز قبل تخصيص مساحة لرمز QR على العبوات أو التذاكر أو ملصقات المعدات.

مقارنة مستويات التصحيح

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

التحقق من حدود الحمولة

حددوا حداً بالبايت لعناوين URL المنشأة أو السجلات المنظمة قبل إرسالها إلى برنامج ترميز QR.

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

ما المقصود بطول البيانات؟

هو عدد البايتات في الحمولة النهائية، وليس بالضرورة عدد المحارف الظاهرة.

ما نمط ترميز QR المستخدم؟

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

ماذا تعني L وM وQ وH؟

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

هل تشمل النتيجة المنطقة الهادئة؟

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

لماذا قد يختار مولد QR إصداراً مختلفاً؟

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

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

تكلفة كل طلب API هي $0.002. تعمل نسخة المتصفح محلياً ومجاناً.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/doc/qr-code-capacity-estimate

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

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

curl -X POST https://api.kit.forhosting.com/doc/qr-code-capacity-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data_length":100,"error_correction_level":"M"}'

const res = await fetch("https://api.kit.forhosting.com/doc/qr-code-capacity-estimate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "data_length": 100,
    "error_correction_level": "M"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/doc/qr-code-capacity-estimate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "data_length": 100,
    "error_correction_level": "M"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/qr-code-capacity-estimate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"data_length":100,"error_correction_level":"M"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"data_length":100,"error_correction_level":"M"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/qr-code-capacity-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "data_length": 100,
  "error_correction_level": "M"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`max_mb`	25
`max_pages`	200

الأخطاء

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

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