CSV إلى JSON

حوِّل بين تنسيقي CSV وJSON في الاتجاهين. ارفع ملف CSV أو TSV للحصول على مصفوفة JSON من الكائنات، أو ارفع مصفوفة JSON للحصول على ملف CSV.

نقطة نهاية API

POST /api/v1/tools/files/csv-json

يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف CSV أو TSV أو JSON وحقل JSON بصيغة settings.

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
pretty	boolean	لا	true	طباعة خرج JSON بتنسيق أنيق مع مسافات بادئة

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

CSV إلى JSON:

curl -X POST http://localhost:1349/api/v1/tools/files/csv-json \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"pretty": true}'

JSON إلى CSV:

curl -X POST http://localhost:1349/api/v1/tools/files/csv-json \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={}'

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

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/users.json",
  "originalSize": 1500,
  "processedSize": 2200
}

ملاحظات

• يُكتشف اتجاه التحويل تلقائيًا من امتداد ملف الدخل: .csv أو .tsv يُنتج .json، و.json يُنتج .csv.
• يؤثّر المعامل pretty في خرج JSON فقط. عند ضبطه على false، يكون الخرج سلسلة JSON مضغوطة في سطر واحد.
• يجب أن يكون دخل JSON مصفوفة من الكائنات ذات مفاتيح متسقة. يصبح كل كائن صفًّا، ويصبح كل مفتاح ترويسة عمود.
• تُدعَم ملفات TSV (قيم مفصولة بعلامات جدولة) إلى جانب CSV.