ForHosting KIT · النصوص والذكاء الاصطناعي

تنسيق نص JSON

حوّل سطر بيانات متراصًا إلى نص منسق بمسافات بادئة: يعود المثال ذو 53 بايت في 79 بايت مقروءة، بمسافتين لكل مستوى. ويُبلَّغ عن أي خلل بموضعه الدقيق بدل التخمين. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

النص: {"name":"Ada","skills":["math","code"],"active":true}

تحصل على

المسافة البادئة: 2
بايتات الإدخال: 53
بايتات الإخراج: 79

مسافة بادئة وموضع خطأ التحليل

لماذا يأتي الفحص قبل الإزاحة

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

للقراءة أو المراجعة أو الضغط

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

ما الذي يحدث فعلًا عند ترتيب النص

بخلاف منسّق بصري يكتفي بإدراج أسطر جديدة دون فهم البنية، يجب على منسّق حقيقي أن يحلّل أولًا: عندها فقط يضمن تطابق الأقواس وإغلاق السلاسل وصحة الأرقام ورفض الفواصل اللاحقة. يعطي indent صفرًا تسلسلًا مضغوطًا في سطر واحد بعد تحليل ناجح—مفيد عندما يُراد التحقق والتصغير في خطوة واحدة. مسافتان أو أربع هي الخيارات المعتادة للمراجعة البشرية.

تُضمَّن أعداد البايتات للإدخال والإخراج حتى تسجّل الأنابيب نسب التوسع عندما تتحول الكتل المضغوطة الكبيرة إلى مستندات متعددة الأسطر.

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

ماذا يفعل indent 0؟

تُحلَّل السلسلة كاملة أولًا، لذا الإدخال غير الصالح يفشل مع موضع.

لماذا تقول الأداة إن نصي غير صالح؟

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

هل الأفضل مسافتان أم أربع مسافات للإزاحة؟

كلاهما خيار شائع عندما سيراجع شخص النتيجة. إن لم تحدد شيئًا تُستخدم مسافتان لكل مستوى، ويمكنك اختيار أي قيمة من 0 إلى 8.

هل يغيّر التنسيق ترتيب بياناتي أو محتواها؟

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

كم يزيد حجم النص بعد التنسيق؟

تعرض الأداة الحجم قبل التنسيق وبعده بالبايت. في المثال يصبح النص ذو 53 بايت 79 بايت بمسافتين لكل مستوى، والفرق هو فواصل الأسطر والإزاحة.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/text/json-pretty-print

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

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

curl -X POST https://api.kit.forhosting.com/text/json-pretty-print \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"{\"name\":\"Ada\",\"skills\":[\"math\",\"code\"],\"active\":true}"}'

const res = await fetch("https://api.kit.forhosting.com/text/json-pretty-print", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "{\"name\":\"Ada\",\"skills\":[\"math\",\"code\"],\"active\":true}"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/text/json-pretty-print",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "{\"name\":\"Ada\",\"skills\":[\"math\",\"code\"],\"active\":true}"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"text":"{\"name\":\"Ada\",\"skills\":[\"math\",\"code\"],\"active\":true}"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/json-pretty-print", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "text": "{\"name\":\"Ada\",\"skills\":[\"math\",\"code\"],\"active\":true}"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_tokens 20000

الأخطاء

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

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

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

ما الذي يفعله تنسيق سلسلة JSON فعليًا

تنسيق نص JSON يعني أخذ سلسلة تدّعي أنها JSON، وتحليلها إلى قيمة، ثم كتابة تلك القيمة مجددًا بعدد ثابت من المسافات لكل مستوى تداخل. تأخذ هذه القدرة حقل text كسلسلة مصدر، وتشغّل تحليل JSON صارمًا، وتعيد حقل text جديدًا بمسافة بادئة متسقة يتحكم فيها المعامل الاختياري indent (عدد صحيح من صفر إلى ثمانية، والافتراضي مسافتان). لا تجلب الخوارزمية مخططات بعيدة، ولا تصلح JSON المكسور، ولا تعيد ترتيب مفاتيح الكائن بما يتجاوز ترتيب التسلسل الطبيعي للمحرك على الكائن المحلَّل. هذا التقييد يبقي العقد بسيطًا: صالح فيدخل منسّقًا، غير صالح فيخرج بخطأ واضح مع موضع.

عقد الإدخال وحقول الاستجابة ومواضع أخطاء التحليل

اختياريًا أرسل indent كعدد صحيح بين صفر وثمانية؛ احذفه لاستخدام مسافتين. عند فشل التحليل يتضمن رسالة الخطأ دائمًا موضع حرف: المحركات التي تبلّغ «at position N» تُعاد بنفس N، والإدخال غير المكتمل يُربط بنهاية السلسلة، والفشل الآخر يفترض الموضع صفرًا حتى يكون للعميل دائمًا هدف للمؤشر. اربط هذه النقطة بمحررك أو عارض السجلات بالانتقال إلى الإزاحة المبلَّغ عنها؛ لا حاجة لاستدعاء تحقق ثانٍ. أرسل عبر POST جسم JSON يتضمن سلسلة text إلزامية تحتوي المستند المراد تنسيقه. يفشل text الفارغ وغير السلسلي وindent خارج النطاق بـ invalid_input ولا تُحسب تكلفته. عند النجاح تتضمن الاستجابة text (المستند المنسّق) وindent (التباعد الفعلي المستخدم) وbytes_in (طول UTF-8 لسلسلة المصدر) وbytes_out (طول UTF-8 للنتيجة المنسّقة). مثال: text يساوي كائنًا مضغوطًا بمصفوفات متداخلة وindent يساوي اثنين يعيد JSON متعدد الأسطر بخطوات مسافتين وأقواس متطابقة. مثال فشل: كائن مقطوع بلا قوس إغلاق ينتج invalid_input يذكر الموضع قرب نهاية الجزء.

أين يثبت تنسيق نص JSON قيمته

يمكن لمهام CI رفض ملفات الإعداد التي تصل مضغوطة من مولّدات أعلى التيار أو إعادة كتابتها، مع فشل سريع بموضع تحليل عندما يُقطع أثر الإصدار أثناء الرفع. تستفيد مواقع التوثيق التي تستهدف pretty print json text من ودجت حيّ يطابق مساره المجاني في المتصفح مسار الأتمتة المدفوع على الوحدة النقية نفسها، فلا تختلف عروض SEO عن سكربتات الإنتاج. التحقق الفاشل لا يستهلك الرصيد. يلصق المطوّرون استجابات API في المحادثات والتذاكر؛ يحوّل تنسيق نص JSON الأسطر المعتمة إلى أشجار قابلة للمراجعة دون تثبيت منسّق سطح مكتب. تُظهر أدوات الدعم للعملاء الإزاحة الدقيقة لجسم webhook تالف بدل لافتة عامة «JSON غير صالح». لأن التنفيذ parse من المستوى A خالص، كل استدعاء ناجح يكلف السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة. فضّل عقد نص داخل ونص خارج عندما يحفظ خط الأنابيب JSON أصلًا كسلسلة—سجلات ومحتويات ملفات وأجسام رسائل—لا ككائن محلَّل مسبقًا.

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

مخرجات API وwebhook مقروءة

حوّل أجسام الطلب أو الاستجابة المضغوطة إلى JSON بمسافات بادئة للتذاكر والمحادثات والتحليل اللاحق، مع موضع تحليل عندما يكون المخرج مقطوعًا.

فحوصات الإعداد والـ fixtures في CI

تحقق من fixtures JSON ونسّقها في الأنابيب؛ اجعل المهمة تفشل بـ invalid_input وإزاحة حرف عندما يُصدِر مولّد صيغة مكسورة.

الدعم والانتقال إلى الخطأ في المحرر

اعرض لوكلاء الدعم والمستخدمين موضع الحرف الدقيق لخطأ صيغة JSON حتى يصحّحوا الفواصل وعلامات الاقتباس أو الأقواس الناقصة بسرعة.

أسئلة تقنية

كيف أنسّق سلسلة JSON؟

أرسل JSON في حقل text واختياريًا عيّن indent (0–8، الافتراضي 2). عند النجاح تستلم text بمسافات بادئة مع bytes_in وbytes_out.

ماذا يحدث إذا كان JSON غير صالح؟

تفشل المهمة بـ invalid_input ورسالة تتضمن موضع حرف خطأ التحليل لتحديد الرمز الخاطئ. الإدخال غير الصالح لا يُحسب.

هل يرتّب تنسيق نص JSON مفاتيح الكائن؟

لا. تحتفظ المفاتيح بالترتيب الطبيعي للمحرك بعد التحليل. تركّز الأداة على المسافات البادئة والتحقق لا على ترتيب مفاتيح حتمي.

كم تكلفة واجهة تنسيق نص JSON؟

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

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

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