Files
SnapOtter/apps/docs/ar/tools/files/json-xml.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.0 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
التحويل بين JSON وXML، في الاتجاهين. b3a6ded0c64a human 710bea199247

JSON إلى XML

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

نقطة نهاية API

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

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

المعاملات

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

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

JSON إلى XML:

curl -X POST http://localhost:1349/api/v1/tools/files/json-xml \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@config.json" \
  -F 'settings={"pretty": true}'

XML إلى JSON:

curl -X POST http://localhost:1349/api/v1/tools/files/json-xml \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@config.xml" \
  -F 'settings={"pretty": true}'

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

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.xml",
  "originalSize": 850,
  "processedSize": 1200
}

ملاحظات

  • يُكتشف اتجاه التحويل تلقائيًا من امتداد ملف الدخل: .json يُنتج .xml، و.xml يُنتج .json.
  • ينطبق المعامل pretty في الاتجاهين. عند false، يكون الخرج مضغوطًا بلا مسافات بادئة.
  • تُحفَظ سمات XML والبنى المتداخلة أثناء التحويل ذهابًا وإيابًا حيثما أمكن.