ForHosting KIT · البيانات والملفات: تحويل وتنظيف

تحويل ملف Excel إلى JSON

أداة تحوّل ملف Excel بصيغة xlsx إلى JSON منظم: كل ورقة عمل تتحول إلى مصفوفة كائنات، وعناوين الأعمدة تصبح مفاتيح جاهزة لأي واجهة برمجية أو تطبيق. تُنفَّذ المعالجة على خوادمنا لأن قراءة ملفات Excel المعقّدة تحتاج محركًا مخصصًا، بسعر ثابت معلن لكل طلب عبر الصفحة أو الـAPI.

موقوفة مؤقتًالكل طلب · لكل 1,000 صف$0.002

هذه المهمة غير متاحة حاليًا، لذا لا يمكن شراؤها. ولا يتم تحصيل أي رسوم مقابلها.

اطّلع على الـAPI

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

لماذا يحتاج ملف Excel معالجة على الخادم

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

أي ورقة تُحوَّل وماذا يحدث للصيغ الحسابية

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

الاستخدام من الصفحة والـAPI معًا

ارفع ملف xlsx من الصفحة واحصل على نتيجة JSON خلال ثوانٍ، أو أرسله عبر الـAPI ضمن مسار عمل آلي. السعر ثابت ومعلن: $0.002 للطلب الواحد، مهما كان عدد صفوف الورقة، حتى حجم 25 MB. لا اشتراك شهريًا ولا رصيدًا مسبقًا؛ الدفع عبر PayPal لكل عملية، أو التواصل معنا مباشرة لحجم أكبر يحتاج ترتيبًا دوريًا. تصل النتيجة بالبنية نفسها في الحالتين، فلا فرق في جودة التحويل بين الاستخدام من الصفحة أو عبر الاستدعاء الآلي.

متى تحتاج JSON بدل جدول Excel نفسه

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

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

ترحيل مخزون من جدول Excel قديم

يحتفظ متجر مؤسسة النخيل للمقاولات بمخزون قطع الغيار في ملف Excel منذ سنوات. عند الانتقال لنظام إدارة مخزون جديد، يحوّلون الملف إلى JSON عبر الـAPI ليقرأه النظام مباشرة دون إدخال يدوي.

دمج كشف رواتب في نظام حضور

يحوّل قسم الموارد البشرية في شركة الخليج الرقمية ملف رواتب شهري بصيغة Excel إلى JSON، ليدمجه تلقائيًا مع نظام الحضور والانصراف الداخلي.

استيراد قائمة عملاء إلى منصة تسويق

تصدّر نورة القحطاني قائمة عملاء من Excel وتحوّلها إلى JSON قبل رفعها إلى منصة بريد تسويقي تقبل الصيغة المهيكلة فقط.

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

هل يمكن استخدام الأداة مجانًا من المتصفح؟

لا، قراءة ملفات Excel المعقّدة تحتاج معالجة على خوادمنا؛ الاستخدام عبر الصفحة أو الـAPI مدفوع بسعر معلن $0.002 للطلب، دون نسخة مجانية.

هل يُحتفظ بملف Excel بعد التحويل؟

لا، يُحذف الملف فور اكتمال الطلب؛ الملفات المالية والإدارية تُعامَل بسرية تامة.

هل تُحوَّل كل الأوراق داخل الملف؟

تُحوَّل الورقة النشطة افتراضيًا؛ لتحديد ورقة أخرى استخدم الـAPI مع اسم الورقة المطلوبة.

ماذا يحدث للصيغ الحسابية داخل الخلايا؟

تُقرأ بقيمتها النهائية المحسوبة لا بمعادلتها النصية.

كم تبلغ التكلفة لملف كبير؟

$0.002 للطلب الواحد، ثابت مهما زاد عدد الصفوف، حتى 25 ميغابايت.

هل يعمل من الجوال؟

نعم، ترفع الملف من متصفح الجوال وتحصل على النتيجة بالطريقة نفسها.

هل الدفع ممكن بالريال أو الدرهم؟

الأسعار بالدولار الأمريكي عبر PayPal؛ لترتيب آخر راسلنا عبر واتساب أو البريد.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/data/xlsx-to-json

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

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

curl -X POST https://api.kit.forhosting.com/data/xlsx-to-json \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"text":"…"}'

const res = await fetch("https://api.kit.forhosting.com/data/xlsx-to-json", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/xlsx-to-json",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "text": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/xlsx-to-json", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"text":"…"}',
  ],
]));
$task = json_decode($res, true);

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

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

{
  "text": "…"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_mb 25

الأخطاء

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

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