Files
SnapOtter/apps/docs/ar/tools/files/csv-json.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.2 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
التحويل بين CSV وJSON، في الاتجاهين. 978c08ad46d3 human beb106cfa248

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 "file=@users.csv" \
  -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 "file=@users.json" \
  -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.