از نمونهی JSON، تایپ TypeScript، اسکیمای Zod و JSON Schema بسازید
وقتی با یک API تازه کار میکنید، معمولاً اول یک نمونه پاسخ JSON دارید و باید برایش تایپ TypeScript بنویسید یا اعتبارسنجی Zod بسازید. نوشتن دستی اینها برای پاسخهای بزرگ و تودرتو وقتگیر است و با یک غلط تایپی خراب میشود. این ابزار از همان نمونه، رابطهای TypeScript، اسکیمای Zod یا JSON Schema نسخهی 2020-12 میسازد.
شیءهای تودرتو نوع نامدار جدا میگیرند، عدد صحیح از اعشاری جدا میشود و گزینههایی برای فقطخواندنی، type بهجای interface، اختیاری با undefined و تبدیل مقدارهای محدود به enum دارید. پردازش در مرورگر شما انجام میشود.
نمونهی JSON را بچسبانید
یک پاسخ واقعی یا نمونهی کامل را در «نمونهی JSON» بگذارید؛ حجم تا ۲ مگابایت است.
نوع خروجی را انتخاب کنید
TypeScript، Zod یا JSON Schema را بردارید.
نام و گزینهها را تنظیم کنید
در «نام نوع اصلی» نامی مثل User بنویسید و گزینههای «فقطخواندنی»، «استفاده از type» و «اختیاری با undefined» را مطابق سبک پروژه انتخاب کنید.
خروجی را بردارید
کد ساختهشده را کپی کنید و پیش از استفاده با چشم مرور کنید؛ آنچه در نمونه نبوده، در تایپ هم نیست.
پاسخ API به TypeScript
شیء داخلی address رابط جدا با نام Address میگیرد.
{"id":1,"name":"علی","tags":["a"],"address":{"city":"تهران"}}نتیجه: export interface Root { id: number; name: string; tags: string[]; address: Address; } export interface Address { city: string; }
همان نمونه به Zod
در Zod عدد صحیح با int() مشخص میشود و نوع TypeScript از خود اسکیما به دست میآید.
{"id":1,"name":"علی","tags":["a"],"address":{"city":"تهران"}}نتیجه: import { z } from "zod"; export const RootSchema = z.object({ id: z.number().int(), name: z.string(), tags: z.array(z.string()), address: z.object({ city: z.string(), }), }); export type Root = z.infer<typeof RootSchema>;
تا ۲ مگابایت؛ پردازش در مرورگر شما انجام میشود.