ForHosting KIT · قراءة المواقع ومراقبتها

تحويل JSON إلى CSV

يمكنكم تحويل مصفوفة JSON إلى ملف CSV موثوق من دون كتابة برنامج أو القلق من أن تؤدي السجلات غير المتسقة إلى إزاحة الأعمدة بصمت.

● Betaمجاني · داخل متصفحك

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

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

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

جهزوا مصفوفة متسقة من الكائنات المسطحة

ابدؤوا بنص JSON صالح تكون قيمته العليا مصفوفة. يجب أن يكون كل عنصر كائناً، وأن تكون قيمة كل حقل قيمة JSON قياسية مفردة: سلسلة نصية أو رقماً أو قيمة منطقية أو null. تُرفض الكائنات والمصفوفات المتداخلة عمداً لأنه لا توجد طريقة صحيحة وحيدة لوضع بنية متداخلة داخل خلية CSV. تحوّل بعض الأدوات القيم المتداخلة إلى نص، بينما تسطّح أدوات أخرى المسارات أو تضاعف الصفوف، ويغيّر كل خيار معنى البيانات. تحافظ هذه الأداة على سلوك متوقع من خلال اشتراط توضيح البنية الجدولية قبل التحويل. يجب أن تحتوي المصفوفة على كائن واحد على الأقل، وأن يحتوي الكائن الأول على مفتاح واحد على الأقل. يصبح ترتيب مفاتيحه هو ترتيب أعمدة CSV، ولذلك رتّبوا السجل الأول وفق الشكل المطلوب في جدول البيانات. يُحفظ ترتيب مفاتيح كائن JSON. قد تتضمن القيم فواصل أو علامات اقتباس أو أحرف رجوع أو فواصل أسطر؛ ولا حاجة إلى معالجتها يدوياً من أجل CSV، إذ يتولى المسلسل ذلك بعد تحليل JSON.

افهموا التحقق الصارم من العناوين والصفوف

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

استخدموا CSV بأمان في الجداول ومسارات العمل

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

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

تصدير سجلات API إلى جدول بيانات

حوّلوا مصفوفة متسقة واردة من API داخلي إلى أعمدة تستطيع فرق العمليات أو الشؤون المالية ترتيبها وتصفيتها ومراجعتها.

إنشاء بيانات اختبار حتمية

أنشئوا ملفات CSV اختبارية ثابتة من سجلات JSON، وأوقفوا العملية فوراً إذا أضاف سجل حقلاً أو أغفله.

التحقق من تسليم بيانات جدولية

افرضوا مخططاً مشتركاً على جميع السجلات قبل تسليم CSV إلى أداة استيراد أو محلل أو عميل أو مسار تقارير.

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

كيف يُختار عنوان CSV؟

يستخدم المحول مفاتيح الكائن الأول بترتيبها القائم. ويجب أن تمتلك جميع الكائنات اللاحقة مجموعة المفاتيح نفسها تماماً.

ماذا يحدث إذا اختلفت مفاتيح الكائنات؟

يفشل التحويل بخطأ إدخال غير صالح يحدد العنصر غير المتطابق. وتُرفض المفاتيح الإضافية والمفاتيح الناقصة معاً.

هل تُقبل الكائنات أو المصفوفات المتداخلة قيماً؟

لا. يجب أن تكون كل قيمة سلسلة نصية أو رقماً أو قيمة منطقية أو null. وحّدوا البيانات المتداخلة أو سطّحوها قبل التحويل.

كيف تُعالج الفواصل وعلامات الاقتباس وفواصل الأسطر؟

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

ما تكلفة التحويل عبر API؟

تبلغ تكلفة كل طلب API ناجح $0.002. وتعمل نسخة المتصفح محلياً ومجاناً.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/web/json-to-csv

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

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

curl -X POST https://api.kit.forhosting.com/web/json-to-csv \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"[{\"name\":\"Ada\",\"role\":\"Engineer\",\"active\":true},{\"name\":\"Grace\",\"role\":\"Admiral\",\"active\":false}]"}'

const res = await fetch("https://api.kit.forhosting.com/web/json-to-csv", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "[{\"name\":\"Ada\",\"role\":\"Engineer\",\"active\":true},{\"name\":\"Grace\",\"role\":\"Admiral\",\"active\":false}]"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/json-to-csv",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "[{\"name\":\"Ada\",\"role\":\"Engineer\",\"active\":true},{\"name\":\"Grace\",\"role\":\"Admiral\",\"active\":false}]"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"text":"[{\"name\":\"Ada\",\"role\":\"Engineer\",\"active\":true},{\"name\":\"Grace\",\"role\":\"Admiral\",\"active\":false}]"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/json-to-csv", 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\",\"role\":\"Engineer\",\"active\":true},{\"name\":\"Grace\",\"role\":\"Admiral\",\"active\":false}]"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`timeout_sec`	30
`max_crawl_pages`	25

الأخطاء

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

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