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

منشئ روابط mailto

أدخل support@example.com مع موضوع ونص، واحصل على رابط mailto جاهز للصق تتحول فيه Hello from the web إلى Hello%20from%20the%20web، ويُرمَّز فيه كل فراغ أو حرف معلَّم أو علامة & بأمان. ويفكك أيضًا رابطًا موجودًا إلى أجزائه. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

وضع الحساب: Encode
To: support@example.com
المادة: Hello from the web
المحتوى (Body): Please review the attached notes.
Cc: ops@example.com
Bcc: archive@example.com

تحصل على

عدد معلمات الاستعلام: 4

رابط mailto هو أصغر جسر بين صفحة ويب وعميل البريد لدى الزائر: نقرة واحدة تفتح مسودة بعنوان المستلم معبأ مسبقًا، وغالبًا بموضوع ونص يوافقان الدعوة إلى الإجراء. بناء تلك الروابط يدويًا سهل حتى يظهر فراغ أو تشكيل أو علامة & أو سطر جديد؛ عندها تنكسر سلسلة الاستعلام أو يُقتطع الموضوع أو يصل النص سطرًا واحدًا تالفًا. يقبل منشئ روابط mailto هذا عناوين المستلمين مع حقول اختيارية للموضوع والنص وcc وbcc، ويطبّق ترميز النسبة المئوية على كل ترويسة كما تتوقع المتصفحات وRFC 6068، ويعيد URI من نوع mailto جاهزًا للصق. وفي الاتجاه الآخر يحلّل رابط mailto قائمًا إلى حقول منظمة لتدقيق القوالب أو ترحيل محتوى CMS أو إعادة القيم عبر نماذجكم.

ما تحمله URI من نوع mailto ولماذا يهم الترميز

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

تُتحقق عناوين المسار وcc أو bcc كعناوين بسيطة local@domain بنطاق منقوط، فتُلتقط أخطاء مثل support@example مبكرًا. يمكن سرد عدة مستلمين بفواصل؛ وتُحذف الترويسات الاختيارية الفارغة من الرابط المُنشأ ليبقى URI قصيرًا ومقروءًا.

أين يثبت منشئ روابط mailto جدواه

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

تؤكد سكربتات ضمان الجودة بالترميز ثم التحليل أن متغيرات القوالب تتوسع إلى URI قانونية قبل الإصدار. لأن التنفيذ parse خالص من المستوى A لا يوجد تسليم بريد صادر ولا استعلام شبكة لسجلات MX ولا تكلفة رموز نموذج — فقط بناء سلاسل وتحقق حتمي. اقرنوه بخط إرسالكم إن احتجتم التسليم؛ تتوقف هذه القدرة عند رابط mailto صحيح وتفكيك أمين لحقول ما لديكم فعلًا.

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

تدقيق وترحيل مراسي mailto القديمة

حلّلوا روابط mailto القائمة في تصديرات HTML لاستعادة المستلمين والمواضيع والنصوص إلى حقول CMS منظمة قبل إعادة كتابة الصفحات.

ضمان جودة ذهابًا وإيابًا لقوالب البريد

رمّزوا متغيرات القالب في URI من نوع mailto ثم حلّلوها مجددًا وتحققوا من تطابق المواضيع والنصوص لاكتشاف انحدارات الترميز قبل الإصدار.

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

كيف أبني رابط mailto بموضوع ونص؟

حقل mailto في الاستجابة هو URI الجاهز للاستخدام بترويسات مرمّزة بالنسبة المئوية.

ما الذي يُعد عنوان بريد غير صالح؟

يجب أن يشبه كل عنوان local@domain.tld بلا مسافات ولا أقواس زاوية. يمكن فصل القوائم بفواصل.

هل يرسل هذا بريدًا؟

لا. يبني أو يحلّل روابط mailto فقط. فتح الرابط ما زال يعتمد على عميل بريد الزائر؛ التسليم وSMTP خارج النطاق.

لماذا تُفسد علامة & في الموضوع رابط mailto؟

لأن العلامة دون ترميز تبدو بداية العنصر التالي، فيُقطع الموضوع عندها. وترمّز الأداة كل قيمة بعلامة النسبة المئوية، فتصل علامات & والاستفهام والفراغات والحروف المعلَّمة وفواصل الأسطر سليمة.

هل يمكنني تفكيك رابط mailto موجود إلى أجزائه؟

نعم. يقسم خيار التحليل الرابط إلى المستلمين والموضوع والنص وcc وbcc، ويفك ترميز كل قيمة. وتُتجاهل العناصر غير المعروفة، ويُرفض الرابط الذي لا يحتوي أي مستلم بدل أن يعود نصف فارغ.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/enc/mailto-encode

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

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

curl -X POST https://api.kit.forhosting.com/enc/mailto-encode \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"encode","op":"encode"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/mailto-encode",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "mode": "encode",
    "op": "encode"
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "mode": "encode",
  "op": "encode"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.mailto_encode",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

المخططات التالفة والعناوين غير الصالحة وتسلسلات النسبة المكسورة تفشل بـ invalid_input بدل نفايات نصف مفكوكة. المنطق النقي نفسه يغذّي أداة المتصفح المجانية ومسار API بسعر $0.002 لكل استدعاء ناجح.

ما تحمله URI من نوع mailto ولماذا يهم الترميز

الترويسات المهمة في عمل المنتج اليومي هي subject وbody وcc وbcc. تطبّق هذه القدرة ترميزًا بأسلوب encodeURIComponent عند الإخراج وفكًا صارمًا عند الإدخال: كل هروب نسبة مئوية يجب أن يكون رقمين سداسيين، والتسلسلات الناقصة ترفع invalid_input بدل إرجاع سلسلة مقطوعة بصمت.

عقد الإدخال وشكل الاستجابة وسلوك الأخطاء

يملأ وضع parse نفس شكل الحقول من المسار ومن أسماء الترويسات المعروفة، ويتجاهل الترويسات المجهولة للتوافق المستقبلي، ويرفض الروابط بلا مستلم في المسار ولا في ترويسات to أو cc أو bcc. طول الحقول محدود حتى لا تستنزف لصقات متعددة الميجابايت ذاكرة العامل؛ حافظوا على مواضيع ونصوص بأحجام بريد عادية فيبقى المسار التحليلي دون الملي ثانية. أرسلوا mode يساوي encode (الافتراضي) مع الحقل الإلزامي to وسلاسل اختيارية subject وbody وcc وbcc. عند النجاح تعيد الاستجابة الحقول المنظمة غير الفارغة والسلسلة الكاملة لـ mailto وعدد معاملات الاستعلام المكتوبة، وتضبط الأعلام المنطقية has_subject وhas_body وhas_cc وhas_bcc حتى يتفرع العميل دون إعادة تحليل URI. لـ mode يساوي parse قدّموا الحقل mailto (تُقبل الأسماء البديلة link وurl وuri وhref) وفيه URI كاملة من نوع mailto؛ يُطابق المخطط دون تمييز حالة الأحرف وتُقص المسافات المحيطة. غياب to عند encode، وURI لا تبدأ بـ mailto، ورموز بريد غير صالحة، وتسلسلات نسبة تالفة تفشل كلها بـ invalid_input ولا تُفوتر.

حالات التكامل

تعبئة مسبقة لأزرار الاتصال والدعم

أنشئوا href من نوع mailto بعنوان دعم ثابت وموضوع خاص بالمنتج وقالب نص اختياري لوِدجات المساعدة وروابط التذييل.

أسئلة تقنية

هل يمكن تحليل URI موجودة من نوع mailto؟

نعم. اضبطوا mode على parse ومرّروا السلسلة الكاملة في mailto (أو link/url/uri/href). تعيد API الحقول to وsubject وbody وcc وbcc عند وجودها مع أعلام للترويسات التي وُجدت.

كم تكلفة منشئ روابط mailto؟

أداة المتصفح مجانية. طلبات API تستخدم رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح؛ الإدخال غير الصالح لا يُفوتر.

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

شغّل الأداة مجانًا

مثال محلول

ما تحمله URI من نوع mailto ولماذا يهم الترميز

أين يثبت منشئ روابط mailto جدواه

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

تدقيق وترحيل مراسي mailto القديمة

ضمان جودة ذهابًا وإيابًا لقوالب البريد

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

ما تحمله URI من نوع mailto ولماذا يهم الترميز

عقد الإدخال وشكل الاستجابة وسلوك الأخطاء

حالات التكامل

تعبئة مسبقة لأزرار الاتصال والدعم

أسئلة تقنية

شكرًا