OpenAPI Spesifikasyonu

OpenAPI Spesifikasyonu (eski adıyla Swagger), bir REST API'yi — uç noktalarını, parametrelerini, istek ve yanıt biçimlerini, kimlik doğrulamasını ve hata kodlarını — tanımlamak için kullanılan, YAML veya JSON ile yazılan standart, makine tarafından okunabilir bir formattır. Tek bir `openapi.yaml` dosyası, API'nin ne yaptığına dair tek doğru kaynak hâline gelir. Asıl gücü araç ekosisteminde yatar. Tek bir spesifikasyondan etkileşimli dokümantasyon, onlarca dilde tipli istemci SDK'ları, sunucu iskeletleri, sahte (mock) sunucular ve sözleşme testleri otomatik üretebilirsiniz; böylece doküman, istemci ve sunucu birbirinden asla kopmaz. SaaS geliştiricileri için bu iki yönden önemlidir. Bir API yayınlıyorsanız, OpenAPI spesifikasyonu sunmak ürününüzü entegre etmeyi çarpıcı biçimde kolaylaştırır; çünkü müşteriler istekleri elle kodlamak yerine bir istemci üretebilir. Bir aracın API'sini kullanıyorsanız, iyi bir spesifikasyonun varlığı entegrasyon kalitesinin güçlü bir göstergesidir ve size günlerce sürecek tahmin yürütmeyi kazandırır. Postman gibi ekosistemlerin temelini oluşturur ve çoğu iPaaS platformundaki API içe aktarma özelliklerini besler.