API Mock & Schema Studio
OpenAPI 3.1 ve JSON Schema'dan sahte API verisi ile TypeScript modelleri üretin.
OpenAPI'den Sahte Veri ve TypeScript Rehberi
OpenAPI 3.1 veya JSON Schema yapıştırın; stüdyo örnek payload ve TypeScript arayüzü üretir. Frontend ve sözleşme testlerinde gerçek API'yi beklemeden ilerlemenizi sağlar. Aşağıda şema türlerinin nasıl okunduğunu, sahte verinin nasıl türetildiğini ve Zod dönüşümüyle nasıl birleştirildiğini detaylandırıyorum.
Sözleşmeden örnek yanıt
Açık şema; alan adı, tip, enum ve iç içe nesneleri tanımlar. Stüdyo bu tanımı dolaşır,string için örnek metin, uuid için geçerli kimlik, number için sayı, enum için listedeki ilk değeri üretir. Dizi alanlarında tek öğelik örnek koleksiyon oluşur; böylece UI boş diziye takılmaz.
TypeScript arayüzü
Aynı şema interface çıktısına çevrilir. Opsiyonel alanlar ? ile işaretlenir, birleşimler union olur. Bu çıktıyı istemci deposuna koyup fetch yanıtını yazabilirsiniz. Çalışma anı doğrulama istiyorsanız mevcut JSON'u JSON to TypeScript & Zod aracına taşıyın.
cURL ve Fetch ile test
Dokümandaki örnek isteği cURL to Modern Fetch ile Next.js Server Action veya Route Handler koduna çevirin. Sahte yanıtı geçici olarak o işleyiciye gömmek, backend hazır olana kadar arayüzü ilerletir.
Ne zaman kullanmalısınız?
Tasarım incelemesi, Storybook hikayeleri, sözleşme testi ve mobil istemci prototipi için uygundur. Üretim verisi yerine geçmez; kimlik, ödeme ve kişisel veri alanlarını elle anonimleştirin. Şema geçersizse hata mesajı anında görünür, sessiz fallback yoktur.