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

إنشاء حمولة QR لشبكات WiFi بنظام WPA أو WEP أو المفتوحة

حمولة QR لشبكة WiFi هي النص المشفّر داخل رمز QR، وتتيح للهاتف التعرّف إلى بيانات اعتماد الشبكة دون أن يكتبها المستخدم.

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

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

تنشئ هذه الأداة الحمولة المعيارية من SSID وكلمة المرور ونوع التشفير الذي تختاره. وهي تدعم WPA وWEP والشبكات المفتوحة، وتهرّب المحارف ذات الدلالة الخاصة في التنسيق، ثم تعيد نصاً جاهزاً لأي برنامج ترميز QR. النتيجة حتمية وسهلة الفحص، وهي متاحة عبر API مقابل $0.002 لكل طلب.

أدخل تفاصيل الشبكة التي تحتاج إليها الأجهزة

ابدأ باسم SSID نفسه الذي تعرضه نقطة الوصول اللاسلكية. أسماء الشبكات حساسة لحالة الأحرف، ولذلك يجب أن تتطابق الأحرف والمسافات وعلامات الترقيم مع ما يظهر للمستخدمين على أجهزتهم. بعد ذلك، أدخل كلمة المرور واختر WPA أو WEP أو none بوصفه نوع التشفير. يناسب WPA إعدادات WPA وWPA2 وWPA3 الشخصية الشائعة التي تمثلها صيغة نص QR الواسعة الدعم هذه. ويظل WEP متاحاً للأجهزة القديمة، في حين يشير none إلى شبكة لا تطلب كلمة مرور. تقبل الأداة أسماء التشفير بصرف النظر عن حالة الأحرف، لكنها ترفض أي قيمة خارج هذه الخيارات الثلاثة كيلا ينتج خطأ كتابي حمولة مضللة بصمت. يتطلب WPA وWEP كلمة مرور غير فارغة. أما في الشبكة المفتوحة فتُهمل كلمة المرور ولا يُنشأ حقل لها. وبذلك يقتصر الناتج على بيانات الاعتماد التي يحتاج إليها الماسح فعلياً، ولا تُضمّن كلمة مرور غير مستخدمة عن طريق الخطأ.

افهم الحمولة وقواعد تهريب المحارف

تبدأ القيمة المعادة بالبادئة WIFI: وتضم حقولاً مسماة تفصل بينها فواصل منقوطة. يحدد الحقل T نوع المصادقة، ويحمل الحقل S قيمة SSID، كما تحصل الشبكات المشفرة على الحقل P الذي يحتوي كلمة المرور. وينهي الحمولة زوج أخير من الفواصل المنقوطة. تستخدم الشبكات المفتوحة القيمة الاصطلاحية nopass وتحذف الحقل P. لبعض المحارف العادية دلالة بنيوية في هذا التنسيق النصي: تبدأ الشرطة المائلة العكسية عملية التهريب، وتنهي الفاصلة المنقوطة الحقل، وقد تفسر أدوات التحليل المتوافقة الفاصلة أو النقطتين بوصفهما فواصل بين القيم. تضع الأداة شرطة مائلة عكسية قبل كل محرف من هذه المحارف حين يظهر داخل SSID أو كلمة المرور. ويكتسب ذلك أهمية خاصة مع أسماء مثل Office:Guest أو كلمات المرور التي تحتوي علامات ترقيم، لأن ضم القيم الخام قد ينتج سلسلة تبدو صحيحة بينما يقسمها الماسح إلى حقول خاطئة. تعيد الأداة الحمولة كنص JSON؛ ولا ترسم صورة أو تعدل بيانات الاعتماد.

رمّز النتيجة واختبرها وشاركها بأمان

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

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

جهّز بطاقة لشبكة الضيوف

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

أتمت ملصقات إعداد الموجّه

ولّد حمولات متسقة من قيم SSID وكلمات المرور المهيأة قبل أن ترسم خدمة منفصلة ملصقات الأجهزة.

عالج علامات الترقيم بأمان

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

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

ما تكلفة الطلب الواحد؟

تبلغ تكلفة كل طلب API مقدار $0.002.

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

لا. فهي تعيد سلسلة WiFi المعيارية التي يمكنك تمريرها إلى برنامج ترميز QR.

ما أنواع التشفير المدعومة؟

تُدعم WPA وWEP وnone. وأي قيمة أخرى تعيد خطأ إدخال غير صالح.

ماذا يحدث لكلمة مرور الشبكة المفتوحة؟

تُهمل، ولا تتضمن حمولة nopass الناتجة أي حقل لكلمة المرور.

هل تُهرّب المحارف الخاصة؟

نعم. تسبق الشرطة المائلة العكسية كل شرطة عكسية أو فاصلة منقوطة أو فاصلة أو نقطتين في SSID أو كلمة المرور.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/enc/qr-wifi-payload

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

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

curl -X POST https://api.kit.forhosting.com/enc/qr-wifi-payload \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ssid":"Studio WiFi","password":"correct horse battery staple","encryption":"WPA"}'

const res = await fetch("https://api.kit.forhosting.com/enc/qr-wifi-payload", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "ssid": "Studio WiFi",
    "password": "correct horse battery staple",
    "encryption": "WPA"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/qr-wifi-payload",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "ssid": "Studio WiFi",
    "password": "correct horse battery staple",
    "encryption": "WPA"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/qr-wifi-payload", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"ssid":"Studio WiFi","password":"correct horse battery staple","encryption":"WPA"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"ssid":"Studio WiFi","password":"correct horse battery staple","encryption":"WPA"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/qr-wifi-payload", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "ssid": "Studio WiFi",
  "password": "correct horse battery staple",
  "encryption": "WPA"
}

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

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