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 مصفوفة من الكائنات، أو كائنًا بمفتاح واحد يحوي مصفوفة كهذه (مثل {"data": [...]})، أو كائنًا مسطّحًا من القيم المفردة. يصبح كل كائن صفًّا، ويصبح كل مفتاح ترويسة عمود. يخرج الكائن المسطّح جدولًا من عمودين key,value. تُرفض الكائنات ذات المفاتيح العليا المتعددة والمصفوفات الفارغة.
• تُدعَم ملفات TSV (قيم مفصولة بعلامات جدولة) إلى جانب CSV.