Files
SnapOtter/apps/docs/ar/tools/files/yaml-json.md
T
SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520)
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
2026-07-15 21:55:51 +08:00

1.9 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
التحويل بين YAML وJSON في الاتجاهين. ef0c9b633797 human 3f6fafb6b475

تحويل YAML / JSON

حوّل بين صيغتَي YAML وJSON في كلا الاتجاهين. ارفع ملف YAML لتحصل على JSON، أو ارفع ملف JSON لتحصل على YAML.

نقطة نهاية API

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

يقبل بيانات نموذج متعدّد الأجزاء (multipart) مع ملف YAML أو JSON. لا يلزم حقل إعدادات.

المعاملات

لا تحتوي هذه الأداة على أي معاملات قابلة للضبط. يُحدَّد اتجاه التحويل من امتداد ملف الإدخال.

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

من YAML إلى JSON:

curl -X POST http://localhost:1349/api/v1/tools/files/yaml-json \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@config.yaml"

من JSON إلى YAML:

curl -X POST http://localhost:1349/api/v1/tools/files/yaml-json \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@config.json"

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

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.json",
  "originalSize": 620,
  "processedSize": 780
}

ملاحظات

  • يُكتشَف اتجاه التحويل تلقائيًا من امتداد ملف الإدخال: .yaml أو .yml يُنتج .json، و.json يُنتج .yaml.
  • يُقبل امتدادا .yaml و.yml معًا.
  • يُحوَّل المستند الأول فقط في ملف YAML متعدّد المستندات؛ وتُتجاهَل المستندات الإضافية المفصولة بـ ---.