OpenAPI 3.x nedir?
OpenAPI, RESTful API'leri tanımlamak için sektör standardı spesifikasyondur. Eski adıyla Swagger, otomatik kod üretimi, belgeleme ve test etmeyi mümkün kılar.
OpenAPI, RESTful API'leri tanımlamak için sektör standardı spesifikasyondur. Eski adıyla Swagger, otomatik kod üretimi, belgeleme ve test etmeyi mümkün kılar.
OpenAPI, HTTP API'lerini tanımlamak için makine tarafından okunabilir bir biçim sağlar ve araçların kodu, belgeleri ve test paketlerini otomatik olarak üretmesini mümkün kılar.
Swagger 1.x ve 2.x, API açıklama biçimlerinin temelini oluşturdu. Spesifikasyon 2015'te OpenAPI Initiative'e bağışlandı ve OpenAPI 3.x'e dönüştü.
Mevcut standart; JSON ve YAML biçimlerini, gelişmiş şema tanımlarını, birden fazla kimlik doğrulama şemasını, webhook'ları ve işlemler arasındaki bağlantıları destekler.
sgcOpenAPI, herhangi bir OpenAPI veya Swagger spesifikasyonunu ayrıştırır ve yerel Object Pascal kodu üretir — Delphi geliştiricilerine birinci sınıf API araçları sunar.
Yollar, HTTP metotları (GET, POST, PUT, DELETE), sorgu parametreleri, başlıklar ve istek gövdelerinin tümü yapılandırılmış bir biçimde tanımlanır.
Veri tipleri, nesne özellikleri, diziler, numaralandırmalar ve kompozisyon (allOf, oneOf, anyOf), istek ve yanıt yüklerinin biçimini açıklar.
API anahtarları, OAuth 2.0 akışları, HTTP Bearer belirteçleri ve OpenID Connect, işlemlere uygulanan yeniden kullanılabilir güvenlik şemaları olarak tanımlanır.