ForHosting KIT · قراءة المواقع ومراقبتها

إنشاء محتوى QR للرابط وWiFi وvCard والرسائل والبريد

صورة QR ليست إلا تمثيلًا مرئيًا لمحتوى نصي، ولكل نوع من المحتوى صيغة محددة. يحوّل هذا المنشئ الحقول المعتادة إلى سلسلة جاهزة للترميز لموقع ويب أو شبكة WiFi أو جهة اتصال vCard أو رسالة SMS أو مسودة بريد إلكتروني.

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

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

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

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

اختاروا نوع المحتوى قبل إدخال حقوله

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

افهموا كيفية معالجة المحارف المحجوزة

تستخدم صيغ محتوى QR علامات الترقيم لبناء الهيكل، ولذلك تحتاج بعض العلامات التي يُدخلها المستخدم إلى الحماية. تفصل الفواصل المنقوطة بين خصائص WiFi، وتفصل النقطتان بين أسماء الخصائص وقيمها. يضيف المنشئ محارف الهروب إلى الشرطات المائلة العكسية وعلامات الترقيم المحجوزة داخل اسم الشبكة أو كلمة المرور، كي تظل بيانات ولا تُفهم كخاصية جديدة. يطبق نص vCard قواعده الخاصة على الشرطات العكسية والفواصل والفواصل المنقوطة والأسطر المضمّنة، وتُركّب البطاقة باستخدام حقول الإصدار 3.0 ونهايات CRLF. ويُمثّل البريد على هيئة URI من نوع mailto. يُرمّز الموضوع والنص كقيم استعلام، فتحفظ المسافات وعلامات العطف والأسطر ومحارف غير ASCII من دون تغيير الهيكل. يستخدم SMS صيغة SMSTO المختصرة التي تدعمها قارئات كثيرة. هذه القواعد خاصة بكل صيغة؛ فالترميز العام للروابط يفسد بنية WiFi وvCard، وترك استعلام البريد بلا ترميز قد يغيّر ما يقرأه الماسح.

استخدموا السلسلة المعادة في مُرمّز أو مجموعة اختبارات

مرّروا المحتوى المعاد من دون تعديل إلى خانة النص في مُرمّز QR. ينبغي للمُرمّز معاملته كبيانات واختيار مستوى تصحيح الأخطاء وحجم الصورة والهامش وصيغة الإخراج؛ فهذه القرارات المرئية منفصلة عن بناء المحتوى. يفيد فصل المرحلتين في أنظمة الإنتاج لأن المحتوى القياسي نفسه يمكنه تغذية شيفرة SVG أو PNG أو PDF أو طابعة ملصقات أو تطبيق جوال من دون تكرار قواعد العمل. كما تصبح الاختبارات مباشرة: احفظوا مدخلات تمثيلية وقارنوا السلسلة الدقيقة، بما فيها نهايات أسطر vCard وفواصل WiFi المحمية، قبل إنشاء أي صورة. إذا تصرف المسح على نحو غير متوقع، افحصوا النص أولًا ثم إعدادات المُرمّز ومدى دعم القارئ. يعمل المنشئ بصورة حتمية ولا يستخدم الشبكة أو العشوائية أو تغييرات الوقت. يناسب المتصفح الطلبات الفردية، بينما تبلغ كلفة API مقدار $0.002 لكل طلب، وهو ملائم للدفعات والقوالب ومسارات النشر وتطبيقات الخادم.

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

إعداد بطاقات WiFi

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

إنشاء ملصقات جهات الاتصال

حوّلوا حقول الاتصال إلى محتوى vCard 3.0 يمكن ترميزه على الشارات والبطاقات ونشرات المنتجات.

اختبار مسار عمل QR

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

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

هل تنشئ هذه الأداة صورة رمز QR؟

لا. إنها تنشئ سلسلة المحتوى التي تمررونها إلى مُرمّز QR منفصل.

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

يمكنكم تشغيلها مجانًا في متصفحكم على هذه الصفحة، أو دفع $0.002 لكل طلب عبر API.

ما أنماط حماية WiFi المدعومة؟

تُدعم WPA وWEP وnopass. يتطلب WPA وWEP كلمة مرور، بينما لا يتطلبها nopass.

أي إصدار من vCard يُنشأ؟

ينشئ النظام vCard 3.0 باسم منظم واسم عرض وأي حقول اتصال اختيارية تقدمونها.

هل يمكن أن يحتوي موضوع البريد ونصه على مسافات أو أسطر جديدة؟

نعم. يُرمّزان كقيم استعلام mailto كي تبقى المحارف المحجوزة والأسطر ضمن النص المقصود.

هل تتحقق الأداة من رابط أو رقم هاتف أو شبكة أو صندوق بريد؟

لا. تتحقق محليًا من البنية المطلوبة، لكنها لا تتصل بخدمات خارجية ولا تؤكد وجود الوجهة.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/web/qr-payload-build

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

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

curl -X POST https://api.kit.forhosting.com/web/qr-payload-build \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"wifi"}'

const res = await fetch("https://api.kit.forhosting.com/web/qr-payload-build", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "type": "wifi"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/qr-payload-build",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "type": "wifi"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/qr-payload-build", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"type":"wifi"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"type":"wifi"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/qr-payload-build", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "type": "wifi"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`timeout_sec`	30
`max_crawl_pages`	25

الأخطاء

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

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