انتقل إلى المحتوى

تحويل JSON إلى TypeScript و Go و Python وغيرها

الصق عينات JSON واحصل على واجهات TypeScript ومخططات Zod وبنى Go وأنواع Python و Java و C# و Kotlin و Swift و Rust، وكلها تُولَّد في متصفحك.

الصق عدة نماذج لدمجها: المفاتيح الغائبة عن بعضها تصبح اختيارية.

TypeScript
الصق نموذجًا ثم اضغط «توليد الأنواع».
صيغة التعريف
تعمل في متصفحك · دون رفعكيف يعمل الموقع

طريقة استخدام تحويل JSON إلى أنواع

  1. 1

    الصق نماذج JSON

    الصق استجابة واحدة، أو مصفوفة من السجلات، أو عدة استجابات واحدة تلو الأخرى؛ ويعرض المثال مستخدمَين مدمجَين.

  2. 2

    اختر اللغة

    اختر TypeScript أو Zod أو Go أو Python أو Java أو C# أو Kotlin أو Swift أو Rust، ثم خيارات النمط الخاصة بها.

  3. 3

    سمِّ النوع الجذر

    حدد اسم النوع في المستوى الأعلى، مثل User أو OrderResponse.

  4. 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 الأصلية.

تحويل JSON إلى أنواع: الأسئلة الشائعة

كيف يحدد المولّد الحقول الاختيارية؟
يكون الحقل اختياريًا إذا خلا كائن واحد على الأقل في ذلك الموضع من المفتاح. إذا لصقت كائنًا واحدًا فكل الحقول مطلوبة، لأن لا شيء يدل على غير ذلك. الصق عدة استجابات حقيقية، أو مصفوفة من السجلات، ليرى المولّد أي المفاتيح يظهر ويغيب. أما خيار «جعل كل الحقول اختيارية» فموجود للبيانات الجزئية أو بيانات patch.
ماذا يحدث عندما تكون القيمة null أحيانًا؟
يصبح الحقل قابلًا لقيمة null: string | null في TypeScript، ومؤشر في Go، و str | None في Python، و String? في Kotlin و Swift، و Option<String> في Rust، ونوع boxed أو nullable في Java و C#. أما الحقل الذي قيمته null في كل النماذج فلا نوع يمكن استنتاجه له، فيصبح نوع JSON المجهول أو الديناميكي في اللغة.
لماذا تحولت أعدادي الصحيحة إلى float؟
إذا ورد في أحد النماذج 7 وفي آخر 7.5 للحقل نفسه، وجب أن يتسع النوع للقيمتين، فيصبح float أو double. والأعداد المكتوبة بفاصلة عشرية، مثل 10.0، تُعد عشرية أيضًا. في TypeScript كلاهما number؛ ومع Zod يُتحقق من الحقل الذي لا يحمل إلا أعدادًا صحيحة عبر z.number().int().
هل هذه الأداة مثل quicktype؟
تحل المشكلة نفسها بمولّد خاص بها يعمل كليًا في متصفحك، وتضيف بعض الأمور: ثلاثة أنماط Python منها TypedDict، ومخططات Zod، ودمج عدة مستندات ملصوقة. أما quicktype فيدعم لغات أكثر ويستطيع قراءة JSON Schema. وفي اللغات التسع المتاحة هنا صُمم الناتج ليُترجَم دون أدوات مساعدة إضافية وقت التشغيل.
هل تكتشف الأداة التواريخ أو enum أو UUID؟
لا. تبقى السلاسل النصية سلاسل نصية، لأن بضعة نماذج لا تثبت أن كل قيمة قادمة ستكون تاريخًا أو واحدة من مجموعة ثابتة. غيّر النوع المولَّد يدويًا إلى Date أو time.Time أو datetime أو enum أو نوع UUID حيث يضمن API لديك ذلك. والاستثناء هو الكائنات التي مفاتيحها UUID أو أرقام أو تواريخ: فهي تصبح maps.