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

إنشاء نص vCard لرمز QR

حوّل الاسم ورقم الهاتف والبريد الإلكتروني والمؤسسة إلى حمولة vCard 3.0 معدة لاستخدامها في رموز QR.

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

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

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

أنشئ حمولة الاتصال قبل توليد رمز QR

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

افهم التهريب ونهايات الأسطر والخصائص الاختيارية

قيم vCard ليست أسطر نص عشوائية. للشرطة المائلة العكسية والفاصلة والفاصلة المنقوطة والسطر الجديد معانٍ بنيوية، وقد يؤدي جمعها مباشرةً إلى تغيير جهة الاتصال أو اختلاف تفسيرها بين تطبيقات العناوين. تهرّب هذه الأداة تلك المحارف في كل قيمة، وتستخدم نهايات CRLF المتوقعة في التنسيق. يتحول السطر الجديد داخل الاسم أو المؤسسة إلى سطر مهرب داخل الخاصية نفسها، لا إلى خاصية جديدة غير مقصودة. يُكتب الاسم في FN. ولا تُضاف TEL وEMAIL وORG للهاتف والبريد والمؤسسة إلا عند بقاء نص بعد إزالة المسافات الخارجية. تبقى المحارف المهمة داخل القيمة كما هي. وتضيف النتيجة CRLF أخيراً بعد END:VCARD لتناسب الأنظمة التي تتوقع سجلاً نصياً منتهياً بالطريقة المعتادة. تحافظ هذه القرارات على حمولة صغيرة ومتوقعة وأمينة للمعلومات التي قدمتموها.

استخدم الحمولة بثبات في مسارات QR المؤتمتة

خذ حقل payload المعاد وقدمه دون تعديل بوصفه المحتوى النصي لمولد QR. لا تحوله إلى JSON مرة ثانية، ولا تستبدل نهايات الأسطر بشرطات ظاهرة؛ إذ يجب أن يرمّز الرمز نص vCard الفعلي. قبل الطباعة أو التوزيع الواسع، اختبر الرمز بعدة كاميرات أو تطبيقات جهات اتصال. يقع سلوك القارئ وحجم الطباعة والتباين وإعداد تصحيح أخطاء QR خارج نطاق هذه الإمكانية، لكنه يؤثر في التجربة النهائية. في الأتمتة، احتفظ بالحقول المصدر المنظمة بجوار الحمولة حتى تعيد إنشاء البطاقة عند تغير جهة الاتصال بدلاً من تحرير نص مرمز. إذا كان منتجكم يتطلب قواعد صارمة، فتحققوا مسبقاً من صحة البريد والهاتف؛ فهذه العملية تعاملهما كسلسلتي اتصال وتركز على التسلسل الآمن. تبلغ كلفة كل طلب API ناجح $0.002. ويعيد الاسم الفارغ أو المكون من مسافات خطأ إدخال واضحاً.

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

أنشئ بطاقة أعمال رقمية

حوّل الهوية المهنية وبيانات الاتصال المباشر إلى الطبقة النصية لرمز QR على بطاقة الأعمال.

شارك جهات الاتصال على بطاقات الفعاليات

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

أتمت موارد دليل الموظفين

أعد إنشاء حمولات الاتصال الجاهزة لـ QR عند تغير الهاتف أو البريد أو المؤسسة.

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

ما إصدار vCard المستخدم في الحمولة؟

تعلن الحمولة VERSION:3.0 وتنشئ سجلاً موجزاً يضم FN وخصائص TEL وEMAIL وORG التي تقدمونها.

هل يمكن حذف الهاتف أو البريد أو المؤسسة؟

نعم. الحقول الثلاثة اختيارية، ولا تنشئ القيمة المحذوفة أو الفارغة خاصية خالية.

لماذا يكون الاسم إلزامياً؟

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

هل تنشئ هذه العملية صورة QR؟

لا. إنها تعيد السلسلة ذات التنسيق القياسي التي تقدمونها إلى مولد رمز QR منفصل.

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

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

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

تبلغ كلفة كل طلب ناجح $0.002. ويمكن تنفيذ التحويل الحتمي نفسه في المتصفح أيضاً.

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

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

الـEndpoint

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

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

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

curl -X POST https://api.kit.forhosting.com/enc/qr-vcard-payload \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Ada Lovelace"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/qr-vcard-payload",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "name": "Ada Lovelace"
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "name": "Ada Lovelace"
}

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

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