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

طبعت رمز QR على قائمة مطعمك؟

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

● مستقرةلكل طلب · لكل رمز QR$0.002

تشغيل — $0.002 + $0.005/رمز QR اطّلع على الـAPI

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

شغّلها أونلاين

شغّل هذه المهمة على خوادمنا باستخدام حسابك. الأدوات المجانية تعمل داخل متصفحك، أما هذه فتُخصم من رصيدك في KIT حسب السعر الموضّح أعلاه.

الفرق الجوهري عن رمز QR العادي

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

متى يستحق فرق السعر؟

طباعة ملصق أو قائمة طعام أو لافتة بكميات كبيرة له تكلفة حقيقية؛ إن توقعت تغيير الرابط الوجهة مرة واحدة على الأقل خلال عمر الملصق — عرض موسمي، قائمة محدَّثة، رابط حملة جديد — يوفّر الرمز الديناميكي تكلفة إعادة الطباعة بالكامل. أما رابط ثابت لن يتغير أبدًا فرمز QR العادي المجاني يكفي دون داعٍ لهذه الخدمة المدفوعة. قارن دائمًا تكلفة إعادة طباعة الكمية المطلوبة مع تكلفة الرمز الديناميكي البسيطة قبل الاختيار، فالفارق يميل غالبًا لصالح الخيار الديناميكي كلما زادت الكمية.

كيف تُغيَّر الوجهة لاحقًا؟

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

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

قائمة طعام موسمية

يغيّر مقهى تابع لمؤسسة النخيل للمقاولات وجهة رمز QR المطبوع على طاولاته كل موسم لعرض قائمة محدَّثة، دون طباعة ملصقات جديدة.

لافتة معرض تجاري

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

بطاقة عمل تتغير وجهتها

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

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

كم مرة يمكن تغيير الوجهة؟

بلا حد أقصى؛ يمكن تغييرها متى شئت طوال عمر الرمز عبر استدعاء واحد للـAPI.

كم السعر؟

$0.002 للطلب، ثم $0.005 لكل رمز QR ديناميكي تنشئه.

هل شكل الرمز المطبوع يتغير عند تعديل الوجهة؟

لا، نقوش الرمز تبقى كما هي تمامًا؛ يتغير فقط المكان الذي يقود إليه خلف الكواليس.

هل تعمل من المتصفح مجانًا مثل رمز QR العادي؟

لا، لأنها تتطلب تخزين الوجهة القابلة للتعديل على خوادمنا باستمرار، فهي خدمة مدفوعة منذ أول رمز.

ماذا يحدث إن ألغيت الرمز الديناميكي لاحقًا؟

يتوقف عن إعادة التوجيه فورًا، ومن يمسحه بعد الإلغاء يصل إلى صفحة توضح أن الرمز لم يعد نشطًا.

هل تُحفظ إحصاءات مسح للرمز الديناميكي؟

نعم يُحفظ عدد مرات إعادة التوجيه؛ استعلم عنها عبر أداة إحصاءات الروابط نفسها المستخدمة للروابط المختصرة.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/dev/qr-dynamic

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

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

curl -X POST https://api.kit.forhosting.com/dev/qr-dynamic \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/qr-dynamic",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "input": "…"
}

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

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

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

الأسعار

لكل طلب$0.002

لكل رمز QR$0.005

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

الأخطاء

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

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