OpenAPI Postman Koleksiyonuna
OpenAPI veya Swagger belgesini kolayca içe aktarılabilecek bir Postman v2.1 koleksiyonuna dönüştür.
OpenAPI Postman Koleksiyonuna
Bir OpenAPI 3 veya Swagger 2 belgesini yapıştırın — JSON veya YAML biçiminde — ve bu araç, doğrudan Postman, Insomnia veya formatı destekleyen başka herhangi bir istemciye aktarabileceğiniz bir Postman v2.1 koleksiyonu oluşturur. Spesifikasyondaki her işlem bir istek haline gelir, büyük bir API'nin gezinilebilir kalması için klasörlere organize edilir, tek bir düz liste olarak görüntülenmek yerine.
İstekleri etiketlere göre veya ilk yol segmentine göre gruplandırın; ekibinizin API hakkında nasıl düşündüğüne bağlı olarak seçin. "Temel URL'yi ortam değişkeni olarak ekle" seçeneğini etkinleştirerek sunucu URL'sini {{baseUrl}} değişkeniyle değiştirin; böylece hazırlama ve üretim arasında geçiş yalnızca bir ortam değişikliği olur, her isteği düzenlemek yerine. "Güvenlik şemasından yetkilendirme başlıklarını ekle" özelliği, spesifikasyonun taşıyıcı, API anahtarı veya OAuth2 tanımlarını okur ve karşılık gelen Authorization veya anahtar başlığını bir yer tutucu olarak ekler. "Şemalardan örnek istek gövdeleri oluştur" seçeneği, her istek için belgede $ref referanslarını izleyerek schemalarından JSON örnekleri oluşturur; böylece POST ve PUT istekleri önceden doldurulmuş olarak gelir, boş olmak yerine. Sorgu parametreleri açıklamalarıyla eklenebilir, eğersiz olarak işaretlenmiş uç noktalar tamamen atlanabilir ve her isteğe temel durum kodu denetimi yapan bir test betiği eklenebilir.
{id} gibi yol parametreleri otomatik olarak Postman'ın :id yol değişkenlerine dönüşür; yapıştırılan belgede CRLF ve LF satır sonları aynı şekilde ele alınır. Yüzlerce işleme sahip büyük spesifikasyonlar tek seferde dönüştürülür; koleksiyon çıktı sınırını aşarsa, sekmeyi dondurmak yerine bunu bildirir.
Her şey yerel olarak tarayıcınızda gerçekleşir — yapıştırdığınız belge, içindeki tüm dahili API ayrıntıları da dahil olmak üzere, hiçbir yere yüklenmez. Koleksiyon hazır olduğunda, kopyalayın, bir dosya olarak indirin veya üzerinde çalışmaya devam etmek için başka bir aracın girişine gönderin.