OpenAPI/Swagger Oluşturucu
Ücretsiz çevrimiçi OpenAPI/Swagger oluşturucu, kurulum gerekmez. API spesifikasyon belgeleri oluşturur
OpenAPI Generator Hakkında
API meta verilerinden (title, version, description, base URL) ve bir uç nokta listesinden OpenAPI 3.0.0 şartnamesini, düzenlenmiş (pretty-printed) JSON olarak oluşturur. Her uç nokta bir HTTP yöntemi, yol, özet, parametreler (query/path/header/cookie), isteğe bağlı istek gövdesi ve yanıt haritası taşır; çıktı, kopyalama düğmeli Preview sekmesinde yayınlanır.
Nasıl Kullanılır
1. Info sekmesinde Title, Version, Description ve Base URL alanlarını doldurun (servers[0].url olarak kullanılır). 2. Endpoints sekmesinde yeni bir uç nokta kartı oluşturmak için Add düğmesine tıklayın. 3. Edit Endpoint formunu açmak için bir karta tıklayın ve Path, Method (GET/POST/PUT/DELETE/PATCH), Summary ve Description alanlarını ayarlayın. 4. Canlı JSON'u görmek için Preview sekmesini açın ve Copy düğmesine tıklayın.
Yol Öğesi Birleştirme
Uç noktalar, yol dizelerine göre yollar altında gruplanır. Her işlem, kendi yol öğesi altında küçük harfli yöntem anahtarıyla (get, post, put, delete, patch) kaydedilir. Parametreler {name, in, schema:{type}, required, description} girdilerine dönüşür. Bir istek gövdesi mevcutsa, genel bir nesne şemasıyla içerik türü anahtarlı content olarak yayınlanır. responses nesnesi, yanıt haritanızdan olduğu gibi yayınlanır.
▶Aynı yoldaki birden fazla işlem nasıl birleştirilir?
▶Araç varsayılan bir yanıt yayınlar mı?
▶Hangi OpenAPI sürümü üretilir?
▶Verilerim bir sunucuya gönderiliyor mu?
Bu araç size yardımcı olduysa, bana bir kahve ısmarlamayı düşünün.
Bana bir kahve ısmarla