إنشاء URI لرابط عميق للتطبيق
ركّب رابطًا يفتح تطبيقك بدل المتصفح: المخطط myapp والمضيف product والمسار /item/42 تعطي myapp://product/item/42، مع ترميز أزواج الاستعلام بعد علامة الاستفهام. وتُمنع الأحرف غير المسموحة في المخطط. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
تعمل هذه الأداة داخل متصفحك — مجانًا، ولا تُرسل بياناتك إلى أي خادم
تفتح تطبيقات الجوّال المحتوى عبر مخططات URL مخصصة مثل myapp://product/item/42? ref=email. تحتاج فرق المنتج والنمو والهندسة إلى أن تكون تلك URI للروابط العميقة سليمة التكوين دائمًا: رمز مخطط قانوني، ومضيف ومسار متوقعان، وأزواج استعلام مرمّزة بالنسبة المئوية تصمد أمام النسخ واللصق في حمولات الدفع وSMS ورموز QR ووجهات الإعلان. السلاسل المبنية يدويًا تنحرف—مسافات في المخطط، وعلامات & غير مُهرَّبة، وأشرطة مائلة ناقصة—وتكسر تدفقات الفتح داخل التطبيق على iOS وAndroid.
ما الرابط العميق بمخطط مخصص وكيف تُجمَّع URI
الرابط العميق للجوّال بمخطط مخصص هو URI يوجّهها نظام التشغيل إلى تطبيقكم المثبت بدل المتصفح. المخطط هو الرمز قبل النقطتين والشرطة المائلة المزدوجة—myapp أو com.example.app أو my-app+v2—ويجب أن يتبع قواعد مخططات URI: حرف أولاً ثم أحرف وأرقام وعلامة زائد ونقطة وشرطة فقط. المسافات والشرطات السفلية والنقطتان والشرطات المائلة داخل المخطط غير قانونية وهي أشيع أخطاء النسخ واللصق عندما يُستخدم اسم منتج كمخطط دون تنقية.
يجمع هذا الباني تلك الأجزاء بترتيب ثابت: المخطط، والحرفي ://، والمضيف (قد يكون فارغًا)، ومسار يكتسب دائمًا شرطة مائلة بادئة واحدة عندما يكون غير فارغ، وسلسلة استعلام فقط عند وجود معلَمة واحدة على الأقل. تُرمَّز مفاتيح وقيم الاستعلام بالنسبة المئوية بنفس قواعد المتصفحات لمكونات بأسلوب application/x-www-form-urlencoded، فتصبح المسافات هروبًا بأسلوب %20 ولا تستطيع الأحرف المحجوزة تقسيم الاستعلام. عندما يكون المضيف فارغًا والمسار /promo يبدو الناتج myapp:///promo؛ وعندما يكون المضيف والمسار فارغين ما زلتم تحصلون على غلاف قانوني scheme:// يصلح كنية بسيطة لفتح التطبيق.
أين يثبت باني URI للروابط العميقة قيمته
تُنشئ خطوط النمو وإدارة علاقات العملاء روابط مخصصة للفتح داخل التطبيق لكل حملة دون أن يُعاد تنفيذ الترميز بالنسبة المئوية على المهندسين. تحتاج أدوات QR والتعبئة إلى سلسلة مستقرة للطباعة؛ والتحقق من المخطط مسبقًا يمنع سحبًا من الإنتاج عندما يلصق أحدهم My App! كمخطط. تربط تطبيقات العلامة البيضاء متعددة المستأجرين كل علامة برمز مخططها مع مشاركة باني واحد لاتفاقيات المسار والاستعلام.
تستفيد مواقع المحتوى التي تنافس على باني URI لرابط عميق لتطبيق جوّال من أداة حية يتطابق مسار متصفحها المجاني مع مسار الأتمتة على نفس الوحدة الخالصة. التحقق الفاشل لا يستهلك الرصيد. احتفظوا بالمخططات في قائمة سماح موثّقة لديكم، وارفضوا الأحرف غير القانونية هنا، فتحصلون على روابط عميقة قابلة لإعادة الإنتاج لـ SMS والبريد والإعلانات والمشاركات داخل التطبيق دون إقامة مُقصّر روابط أو مكدس إسناد لمجرد تجميع URI.
الأسئلة الشائعة
ما أحرف المخطط المسموحة؟
RFC 3986: حرف أولاً ثم أحرف وأرقام وزائد (+) ونقطة (.) وشرطة (-) فقط.
كيف يبدو الرابط من دون مضيف؟
إذا كان المضيف فارغًا والمسار /promo يصبح الرابط myapp:///promo بثلاث شرطات مائلة. وإذا كان المضيف والمسار فارغين معًا، تحصل مع ذلك على رابط صالح مثل myapp:// يكتفي بفتح التطبيق.
كيف تُعالج المسافات والرموز في الاستعلام؟
يُرمَّز كل مفتاح وكل قيمة بالقواعد نفسها التي تستخدمها المتصفحات في النماذج، فتتحول المسافة إلى رمز هروب، ولا تستطيع علامة العطف تقسيم الاستعلام إلى أزواج خاطئة.
كم زوج استعلام يمكن أن يحمله الرابط؟
حتى 50 زوجًا. ويجب أن يبقى في كل مفتاح نص بعد حذف المسافات من طرفيه، أما القيم فيمكن أن تكون نصًا أو أرقامًا أو صحيحًا وخطأ، وتتحول كلها إلى نص قبل الترميز.
لماذا تظهر شرطة مائلة قبل المسار؟
لأن المسار غير الفارغ يحصل دائمًا على شرطة مائلة واحدة في أوله: item/42 و/item/42 يعطيان الرابط نفسه. وهكذا تبقى النتيجة متوقعة مهما كانت طريقة كتابة المسار.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/web/deep-link-scheme-build \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"scheme":"myapp"}'const res = await fetch("https://api.kit.forhosting.com/web/deep-link-scheme-build", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"scheme": "myapp"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/web/deep-link-scheme-build",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"scheme": "myapp"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/deep-link-scheme-build", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"scheme":"myapp"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"scheme":"myapp"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/deep-link-scheme-build", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"scheme": "myapp"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "web.deep_link_scheme_build",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
timeout_sec | 30 |
max_crawl_pages | 25 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
تقبل هذه القدرة مخططًا مخصصًا، ومضيفًا اختياريًا، ومسارًا اختياريًا، وقائمة اختيارية من أزواج مفتاح/قيمة للاستعلام، وتتحقق من المخطط وفق إنتاج RFC 3986، وتُطبّع المسار، وترمّز الاستعلام، وتعيد سلسلة deep_link النهائية مع حقول صدى منظمة. تفشل أحرف المخطط غير الصالحة بـ invalid_input بدل إصدار URI مكسور بصمت. المنطق الخالص نفسه يغذي أداة المتصفح المجانية ومسار API، فلا تختلف مولدات التسويق وعمال الخلفية على الترميز.
ما الرابط العميق بمخطط مخصص وكيف تُجمَّع URI
بعد scheme:// يأتي مضيف اختياري (يُسمى أحيانًا authority) مثل product أو open أو auth، ثم مسار اختياري مثل /item/42، ثم سلسلة استعلام اختيارية من أزواج مفتاح يساوي قيمة مربوطة بعلامات &. تعكس الاستجابة scheme وhost وpath وquery_params وquery_string وdeep_link وhas_query حتى يسجّل العملاء أجزاءً منظمة دون إعادة تحليل URI. لأن الخوارزمية خالصة وحتمية، تعطي المدخلات نفسها دائمًا نفس deep_link بايتًا ببايت على مسار المتصفح المجاني ومسار API المدفوع.
عقد الإدخال وقواعد التحقق وسلوك الأخطاء
يُقبل خمسون زوجًا كحد أقصى. يجب أن يكون كل key غير فارغ بعد القص؛ ويجوز أن تكون القيم سلاسل أو أرقامًا أو منطقيات وتُحوَّل إلى سلسلة قبل الترميز. أرسلوا جسم JSON عبر POST مع scheme كالحقل الوحيد الإلزامي بصرامة: سلسلة غير فارغة بعد القص تطابق نمط حرف ثم أحرف وأرقام وزائد ونقطة وشرطة. تُقبل الأسماء البديلة url_scheme وcustom_scheme وprotocol. host اختياري والقيمة الافتراضية سلسلة فارغة؛ وعند تعيينه يجب ألا يحتوي مسافات أو شرطة مائلة أو علامة استفهام أو #. path اختياري؛ وعند كونه غير فارغ يجب ألا يحتوي مسافات أو علامة استفهام أو #، وتُدرج شرطة مائلة بادئة إن حذفتموها فيصبح item/42 هو /item/42. query_params مصفوفة اختيارية من كائنات، لكل منها key إلزامي وvalue اختياري (افتراضي سلسلة فارغة)؛ وتعمل الأسماء البديلة query وparams وsearch_params بالمثل. غياب scheme أو فراغه، وscheme بأحرف غير صالحة، وأحرف غير قانونية في host أو path، وquery_params غير مصفوفة، أو مفاتيح فارغة تفشل كلها بـ invalid_input ورسالة واضحة تسمي المشكلة—ولا تُفوتر تلك الإخفاقات. عند النجاح تتلقون scheme وhost وpath مطبَّعة؛ وقائمة query_params مطبَّعة؛ وquery_string بلا علامة استفهام بادئة؛ وdeep_link كـ URI كاملة؛ وhas_query كقيمة منطقية. مثال: scheme هو myapp وhost هو product وpath هو /item/42 وquery_params بـ ref يساوي email وutm_source يساوي newsletter ينتج myapp://product/item/42? ref=email&utm_source=newsletter. اقرنوا deep_link بنطاقات التطبيق المرتبطة أو مرشحات intent على العميل؛ يبني هذا الطرف سلسلة URI فقط ولا يسجّل المخططات لدى نظام التشغيل ولا يتحقق من تثبيت التطبيق.
أين يثبت باني URI للروابط العميقة قيمته
تجمع خلفيات إشعارات الدفع scheme ومضيف الشاشة ومعرّف الكيان في حقل deep_link واحد يستطيع عميل الجوّال تحليله عند البدء البارد. تثبّت اختبارات ضمان الجودة والعقود مخرج deep_link في تثبيتات ذهبية حتى لا يغيّر إعادة هيكلة قوالب التسويق أهداف الفتح بصمت. لأن التنفيذ parse خالص من الطبقة A، تكلف كل مكالمة ناجحة السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة.
حالات التكامل
روابط الحملات وإدارة علاقات العملاء للفتح في التطبيق
ابنوا روابط عميقة مخصصة myapp://host/path?utm… للبريد وSMS والإعلانات من مخطط مُتحقق وخريطة استعلام.
أهداف حمولة إشعار الدفع
اجمعوا scheme ومضيف الشاشة ومسار الكيان في سلسلة deep_link واحدة يفتحها عميل الجوّال عند النقر على الإشعار.
QR والتعبئة والذهبيات لضمان الجودة
ولّدوا URI روابط عميقة قابلة للطباعة وثبّتوا قيم deep_link مستقرة بايتًا في الاختبارات حتى لا تُشحن مخططات غير قانونية.
أسئلة تقنية
كيف أبني URI لرابط عميق لتطبيق جوّال؟
أرسلوا مخططًا مخصصًا (إلزامي)، ومضيفًا ومسارًا اختياريين، وquery_params اختيارية كأزواج {key, value}. تعيد API قيمة deep_link بالشكل scheme://host/path?query مع معلمات مرمّزة بالنسبة المئوية.
ماذا يحدث إذا احتوى المخطط أحرفًا غير صالحة؟
تفشل المهمة بـ invalid_input ورسالة تسمي المخطط غير الصالح. لا تُعاد deep_link ولا تُفوتر المكالمة.
هل المضيف أو المسار إلزاميان؟
لا. كلاهما افتراضيًا فارغ. يمكنكم إصدار scheme:// وحده أو scheme://host أو scheme:///path أو الشكل الكامل scheme://host/path?query.
كم يكلف باني URI للروابط العميقة؟
أداة المتصفح مجانية. طلبات API تستخدم رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل مكالمة ناجحة؛ الإدخال غير الصالح لا يُفوتر.