مُرمِّز Q للترويسات
أدخل الحروف ذات العلامات في موضوع الرسالة أو اسم المرسل دون أن تتلف: يصبح Hello café هو =?UTF-8?Q?Hello_caf=C3=A9?=، وتعود الكلمة المرمّزة الملصقة نصًا مقروءًا. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- النص
- Hello café
- وضع الحساب
- Encode
- النتيجة
- =?UTF-8?Q?Hello_caf=C3=A9?=
- الترميز
- rfc2047-q
- مجموعة الأحرف
- UTF-8
- الصيغة
- Encoded word
يحوّل مُرمِّز Q للترويسات هذا نص UTF-8 الصريح إلى شكل Q وفق RFC 2047 المستخدم داخل كلمات MIME المرمّزة لترويسات البريد غير ASCII، ويفكّ تلك السلاسل إلى نص مقروء. charset? Q? …? من الفحوصات الشائعة ترميز Hello café إلى =? UTF-8? Q? Hello_caf=C3=A9? = وفكّ تلك السلسلة إلى العبارة الأصلية.
ما ترميز Q في RFC 2047 وما الذي يعيده هذا الأداة
يعرّف RFC 2047 الكلمات المرمّزة حتى تستطيع ترويسات البريد التي كانت تتوقع أساسًا ASCII أن تحمل نصًا دوليًا دون كسر قواعد مسار SMTP. تبقي طريقة Q معظم النص اللاتيني مقروءًا على طرف بسيط: يظهر ASCII القابل للطباعة الآمن كما هو، وتُكتب المسافة يُفضّل كشرطة سفلية، ويصبح أي ثُماني آخر علامة يساوي متبوعة برقمين ست عشريين بأحرف كبيرة. يجب تهريب علامة اليساوي وعلامة الاستفهام والشرطة السفلية عندما تظهر كبيانات لأنها عناصر بنيوية في قواعد الكلمة المرمّزة.
فواصل الأسطر اللينة من quoted-printable المتن لا تنطبق هنا: الكلمة المرمّزة رمز ذري واحد ويجب ألا تحتوي تسلسل فاصل لين. إن احتجت تعبئة ثنائية معتمة للترويسات ففضّل طريقة B أو مساعد Base64؛ هذه الصفحة لمسار Q المقروء الذي ما زالت المواضيع وأسماء العرض تستخدمه يوميًا.
أين يناسب ترميز Q في ترويسات البريد وMIME وملفات الاختبار
يواجه المطوّرون ترميز Q في RFC 2047 عند فحص أسطر Subject تبدأ بيساوي-استفهام UTF-8 استفهام Q، أو صياغة أسماء عرض دولية لترويسات From وTo، أو تصحيح سبب تحوّل لهجة café إلى شرطة سفلية وأزواج يساوي-ست عشري في تفريغ رسالة خام. تفكّ فرق الواجهة والدعم مقاطع Q أثناء التحقيق في التذاكر دون لصق البيانات في سكربتات مرتجلة تسيء معاملة الشرطة السفلية بدل المسافة أو تخلط quoted-printable المتن بقواعد Q للترويسة.
ترمّز خدمات الخلفية عينات إعداد أو سلاسل متعددة اللغات قصيرة قبل وضعها في حقول ترويسة لا يُضمن فيها نقل 8 بت بلا قيود. يولّد مهندسو الجودة أزواج encode وdecode حتمية لاختبارات العقد حتى لا تستطيع مكتبة بريد تدّعي دعم RFC 2047 تغيير حالة الست عشري بصمت أو ترك مسافات بلا تهريب أو قبول تسلسلات يساوي تالفة. يستخدم المعلّمون الأداة نفسها عند شرح الفرق بين فواصل quoted-printable اللينة في المتن وذرات Q في الترويسة التي يجب أن تبقى على رمز واحد.
اقرنه بمساعدات MIME quoted-printable عند العمل على المتون لا الترويسات، وبمساعدات Base64 عندما تكون كلمة مرمّزة بطريقة B الخيار الأنسب لبيانات ترويسة كثيفة المظهر الثنائي.
حالات الاستخدام
تصحيح Subject واسم العرض
رمّز أو فكّ أجزاء Subject وFrom لاسم العرض المرمّزة ب Q وفق RFC 2047 حتى تطابق اللهجات والمسافات ما تعرضه عملاء البريد.
تجهيز ترويسات لبوابات قديمة
حوّل نص UTF-8 الصريح إلى رموز ترويسة مرمّزة ب Q آمنة للنقل قبل الإرسال عبر مسارات بريد 7 بت مقيّدة.
الأسئلة الشائعة
ما الفرق بين ترميز Q في الترويسة وquoted-printable في المتن؟
ترميز Q في الترويسة (RFC 2047) يربط المسافة بشرطة سفلية، ويمنع فواصل الأسطر اللينة داخل كلمة مرمّزة، ويعامل = و? و_ كرموز خاصة. أما quoted-printable في المتن (RFC 2045) فيستخدم =20 للمسافة وفواصل لينة لإبقاء الأسطر تحت 76 حرفًا.
لماذا تتحول المسافات إلى شرطات سفلية؟
لأن الكلمة المرمّزة يجب أن تبقى كتلة واحدة بلا فراغات داخل الترويسة، فيكتب أسلوب Q كل مسافة شرطة سفلية. وعند الفك تعود كل شرطة سفلية مسافة، أما الشرطة السفلية الحقيقية في النص فتُهرَّب.
ماذا يعني =?UTF-8?Q? في البداية؟
هو غلاف الكلمة المرمّزة: اسم مجموعة المحارف أولًا، ثم الحرف Q الدال على الأسلوب، ثم النص المرمّز، ويُغلق بالعلامة ?=. تضيفه الأداة عند الترميز ما لم تطلب المحتوى وحده.
ما المحارف التي يجب تهريبها في ترميز Q؟
علامة يساوي وعلامة الاستفهام والشرطة السفلية عندما تكون جزءًا من النص، لأنها تدخل في بنية الكلمة المرمّزة. وأي بايت آخر غير آمن يصبح علامة يساوي يليها رقمان ست عشريان بحروف كبيرة.
هل أستخدم ترميز Q أم B في الترويسة؟
استخدم Q عندما يكون النص بحروف لاتينية في أغلبه، لأنه يبقى مقروءًا في الرسالة الخام. أما B المبني على Base64 فيناسب البيانات الكثيفة، وهذه الأداة تعالج صيغة Q وحدها.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/enc/quoted-printable-q \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Hello café"}'const res = await fetch("https://api.kit.forhosting.com/enc/quoted-printable-q", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Hello café"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/quoted-printable-q",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Hello café"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/quoted-printable-q", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Hello café"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Hello café"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/quoted-printable-q", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"text": "Hello café"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.quoted_printable_q",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
بخلاف quoted-printable في متن الرسالة، تربط ترميز Q في الترويسة كل مسافة بشرطة سفلية، وتمنع فواصل الأسطر اللينة داخل الكلمة المرمّزة، وتحجز علامة الاستفهام والشرطة السفلية حتى لا يخلط محلل البريد الحمولة مع الإطار =? =. اختر encode لتحويل جزء موضوع أو اسم عرض أو عبارة اختبار إلى رمز ترويسة آمن للنقل، أو decode لاستعادة النص الأصلي من حمولة Q أو كلمة مرمّزة كاملة تملكها. المحرك حتمي بالكامل: المدخلات وmode وcharset وform نفسها تنتج النتيجة نفسها دائمًا، بلا استدعاءات شبكة ولا أملاح عشوائية ولا اختصارات تعتمد على التاريخ. استخدمه مجانًا في المتصفح لتصحيح البريد وتمارين الترويسات، أو استدعِ واجهة API بسعر $0.002 لكل طلب ناجح عندما تحتاج المسارات تحويلات RFC 2047 قابلة للتكرار في CI وخدمات الخلفية.
ما ترميز Q في RFC 2047 وما الذي يعيده هذا الأداة
تبدو الكلمة المرمّزة على شكل يساوي-استفهام charset استفهام encoding استفهام حمولة استفهام-يساوي، حيث حرف الترميز هو Q للطريقة الشبيهة ب quoted-printable أو B ل Base64. تلتزم هذه الصفحة دائمًا بذلك العقد لنص UTF-8 افتراضيًا: يحوّل وضع encode سلسلتك إلى بايتات charset، ويُصدر شرطة سفلية للمسافة ويساوي-ست عشري للبايتات غير الآمنة، ثم يلفّ الحمولة اختياريًا ككلمة مرمّزة كاملة؛ ويقبل وضع decode كلمة مرمّزة كاملة أو حمولة Q عارية، ويوسّع الشرطة السفلية وأزواج اليساوي-ست عشري، ويرفض التسلسلات الناقصة أو غير الست عشرية بدل التخمين. تتضمن استجابة JSON الحقل result للسلسلة المحوّلة، وmode الذي يعيد encode أو decode، وencoding ثابتًا على rfc2047-q، وcharset، وform (encoded_word أو payload)، وحقل payload العاري لتأكيدات سهلة، وinput_bytes مع output_bytes لتثبيت الأحجام في الاختبارات. لا مسار بث ولا إصلاح صامت لنص Q تالف: إما أن تكون السلسلة صالحة أو يفشل الطلب ب invalid_input.
كيف تُقرأ text وmode وcharset وform وكيف تبقى النتائج قابلة للتكرار
charset? Q? …? يقبل encode سلاسل Unicode ويحوّلها بقواعد charset المختار ثم يُصدر رموز Q بتهريبات ست عشرية بأحرف كبيرة وشرطة سفلية لكل مسافة. بعد استعادة البايتات يضمن فك UTF-8 القاتل ألا يصبح القمامة الثنائية نصًا مشوّهًا عندما يكون charset هو UTF-8. حقل الحمولة المفضّل هو text، مع الأسماء البديلة input وvalue وs حتى تعيد النماذج وسلاسل الاستعلام وعملاء SDK استخدام العقد نفسه دون إعادة تسمية الأعمدة. يكون mode افتراضيًا encode ويقبل decode صراحة؛ وتُقابل الأسماء البديلة op وdirection وaction نفس المفتاح للنصوص التي تستخدم تلك الأسماء أصلًا. يكون charset افتراضيًا UTF-8 ويُكتب في الكلمة المرمّزة عند الترميز؛ وعند فك كلمة مرمّزة كاملة يُؤخذ charset من الرمز نفسه، وعند فك حمولة عارية يختار معامل charset كيف تصبح البايتات المستعادة نصًا. يكون form افتراضيًا encoded_word حتى يعيد encode سلسلة كاملة =? = جاهزة لجزء Subject أو From لاسم العرض؛ اضبط form على payload عندما تريد جسم Q الداخلي فقط لاختبارات الوحدات أو لتركيب ترويسات متعددة الأجزاء بنفسك. يتطلب decode سلسلة Q سليمة الشكل: يساوي وحيد في نهاية المدخل، أو يساوي متبوع بحرف واحد فقط، أو يساوي متبوع بأرقام غير ست عشرية تفشل برسالة invalid_input واضحة تسمّي التهريب المعطوب. اقرن التشغيل المجاني في المتصفح على هذه الصفحة بواجهة API المسعّرة عندما تحتاج النتيجة الرياضية المطابقة داخل مسار آلي دون إعادة تنفيذ جداول RFC 2047 بنفسك. المدخلات غير الصالحة تعيد invalid_input ولا تُحاسب، ما يبقي التحقق رخيصًا بينما تبقى التحويلات الناجحة بسعر عنصر ثابت قدره $0.002.
أين يناسب ترميز Q في ترويسات البريد وMIME وملفات الاختبار
على هذه الصفحة يعمل كل شيء داخل متصفحك؛ عبر API تكلّف كل استعلام ناجح $0.002، ولا يُحاسب التحقق الفاشل، ولا يُخزَّن شيء بعد إعادة الاستجابة. هذا التقسيم — استكشاف تفاعلي مجاني وAPI مسعّرة بنتيجة مطابقة — يوافق بقية كتالوج KIT من المستوى A ويتيح الانتقال من عرض صفّي إلى مسار آلي دون تغيير النتيجة المرمّزة.
حالات التكامل
توليد ملفات ترويسة البريد للاختبار
أنتج كلمات مرمّزة قابلة للتكرار لاختبارات الوحدات وملفات golden وفحوصات تكامل SMTP أو IMAP التي تؤكد شكل الترويسة.
أسئلة تقنية
كم يكلف مُرمِّز Q للترويسات؟
هو مجاني في متصفحك على هذه الصفحة. عبر API يكلف الطلب الناجح $0.002؛ والمدخلات غير الصالحة لا تُحاسب.
ما الأوضاع والأشكال المدعومة؟
mode=encode (الافتراضي) يحوّل النص الصريح إلى ترميز Q؛ وmode=decode يعيد سلسلة Q إلى نص. form=encoded_word (الافتراضي عند الترميز) يلفّ ك =?charset?Q?payload?=؛ وform=payload يعيد جسم Q الداخلي فقط.
ماذا يحدث إذا كان تسلسل التهريب معطوبًا؟
يفشل decode ب invalid_input. يُرفض =XX الناقص والأرقام غير الست عشرية بعد = والأحرف غير المسموحة في حمولة Q بدل التخمين.
هل النتيجة حتمية؟
نعم. نفس text وmode وcharset وform تنتج دائمًا النتيجة نفسها بلا شبكة ولا عشوائية ولا سلوك يعتمد على التاريخ.