طريقة استخدام تحويل JSON إلى أنواع
- 1
الصق نماذج JSON
الصق استجابة واحدة، أو مصفوفة من السجلات، أو عدة استجابات واحدة تلو الأخرى؛ ويعرض المثال مستخدمَين مدمجَين.
- 2
اختر اللغة
اختر TypeScript أو Zod أو Go أو Python أو Java أو C# أو Kotlin أو Swift أو Rust، ثم خيارات النمط الخاصة بها.
- 3
سمِّ النوع الجذر
حدد اسم النوع في المستوى الأعلى، مثل User أو OrderResponse.
- 4
ولّد الأنواع وانسخها
اضغط «توليد الأنواع»، ثم انسخ الكود أو نزّله؛ وعند أي تعديل يُعاد توليده تلقائيًا.
الحدود وخطة Pro
مجانًا ودون تسجيل: 9 لغات للناتج مع 3 أنماط Python، وأي عدد من النماذج المدمجة، وملفات حتى 20 MB، مع إيقاف التوليد بعد 30 ثانية.
يزيل Pro الإعلانات؛ والمولّد نفسه في كل الخطط. عرض Pro
عن تحويل JSON إلى أنواع
كتابة الأنواع يدويًا لاستجابة API عمل بطيء وعرضة للأخطاء، خصوصًا عندما تكون البيانات متداخلة على ثلاثة مستويات. الصق نموذج JSON واحدًا أو أكثر، فيستنتج هذا المولّد البنية ويكتب تعريفات جاهزة للصق بتسع صيغ: واجهات TypeScript أو type aliases، و TypeScript مع مخططات Zod للتحقق وقت التشغيل، و structs في Go مع وسوم json، و dataclasses أو TypedDict أو نماذج Pydantic v2 في Python، و records في Java مع تعليقات Jackson، وأصناف C# لمكتبة System.Text.Json، و data classes في Kotlin لمكتبة kotlinx.serialization، و structs من نوع Codable في Swift، و structs في Rust لمكتبة serde.
نادرًا ما يُظهر نموذج واحد كل الحقول، لذلك يدمج المولّد كل ما تعطيه من نماذج. الصق عدة مستندات واحدًا تلو الآخر أو بصيغة JSON Lines، أو مصفوفة من الكائنات: المفتاح الغائب عن بعض الكائنات يصبح اختياريًا، والمفتاح الذي تكون قيمته null أحيانًا يصبح قابلًا لقيمة null، والعدد الصحيح الذي يأتي عشريًا أحيانًا يصبح float، والقيم المختلطة فعلًا تصبح union أو نوع JSON الديناميكي في اللغة. تحصل الكائنات المتداخلة على أنواع مسماة خاصة بها، فيصبح orders النوع Order ويصبح addresses النوع Address، وتُولَّد البنى المتطابقة مرة واحدة ويُعاد استخدامها. أما الكائنات التي مفاتيحها أرقام أو UUID أو تواريخ فتتحول إلى maps.
تُحوَّل أسماء الحقول إلى العرف المتبع في كل لغة، وتُربط مفاتيح JSON المختلفة عنها، مثل first-name أو class، بأسمائها الأصلية عبر التعليق أو الاسم البديل أو CodingKeys المناسب. ويتسامح المولّد مع التعليقات والفواصل الزائدة في النموذج.
يصف الناتج النماذج التي تقدمها فقط؛ فالمولّد لا يستطيع معرفة حقول أو قيم لا تحتويها نماذجك، لذا راجعه على توثيق API لديك قبل الاعتماد عليه.
الخصوصية
يحلل Web Worker في هذا التبويب النماذج ويولّد الكود، لذلك لا تُرفع أبدًا استجابات API التي تحتوي على بيانات شخصية أو داخلية. تُحفظ خيارات اللغة والتسمية في التخزين المحلي، أما نص JSON الذي تلصقه فلا يُحتفظ به.
الميزات
دمج نماذج عديدة
تصبح المفاتيح الغائبة اختيارية والقيم null قابلة لقيمة null عبر كل النماذج التي تلصقها.
9 لغات
TypeScript و Zod و Go و Python و Java و C# و Kotlin و Swift و Rust بتسمية توافق أعراف كل لغة.
ربط المفاتيح مضمَّن
وسوم json والأسماء البديلة و @SerialName و @JsonProperty و CodingKeys تحفظ أسماء JSON الأصلية.