Od Swaggeru k OpenAPI: jak se vedlejší projekt stal jazykem webových API

Příběh specifikace, která vznikla u internetového slovníku a skončila s podporou Googlu, Microsoftu i IBM.

Zajímavost

Na začátku roku 2010 začal Tony Tam, vývojář internetového slovníku Wordnik, budovat Swagger, aby si poradil s chaosem API vlastní firmy. Nikdo od toho moc nečekal. Přesto v březnu 2015 koupila společnost SmartBear Software specifikaci od Reverb Technologies, mateřské firmy Wordniku, a v listopadu 2015 ji věnovala nově založené OpenAPI Initiative pod hlavičkou Linux Foundation. Google, Microsoft, IBM, PayPal i Capital One se přidali jako zakládající členové. 1. ledna 2016 byla specifikace Swagger oficiálně přejmenována na OpenAPI Specification. Nástroj načrtnutý ve firmě dělající slovník je dnes de facto jazykem, jímž web popisuje svá API.

Stručný návod k nástroji

  1. Otevřete OpenAPI / Swagger vizualizér.
  2. Vložte svůj OpenAPI dokument (JSON nebo YAML) do vstupního pole.
  3. Nástroj rozebere endpointy, parametry i schémata a zobrazí přehledný interaktivní přehled.
  4. Kliknutím na endpoint si prohlédnete detaily požadavku a odpovědi.
  5. Vizualizaci pošlete týmu místo zdi syrového YAML.

Vyzkoušejte nástroj

OpenAPI / Swagger vizualizér →

Další čtení

Swagger (software) — článek na Wikipedii