Pendahuluan mengenai Dokumentasi API, silahkan lihat di sini

Mengenai OpenAPI sendiri, silahkan lihat di sini

Apa bedanya OpenAPI dengan Swagger ?

Yes, kita biasanya mendengar tentang Swagger ketika berbicara mengenai dokumentasi API.

Terutama kita biasanya mendengar spesifikasi Swagger 2.0.

Atau juga ada namanya Swagger-ui untuk antarmuka web nya.

Swagger juga berupa dokumentasi API.

Jadi bedanya dimana ?

Tadaaaa….

Tidak ada bedanya.

Swagger adalah OpenAPI, dan OpenAPI adalah swagger.

Lho..kok bisa.

Tunggu..tunggu , ini tidak mungkin.. Tidak mungkin 2 benda merupakan benda yang sama dalam satu waktu dan dalam satu context.

Betul sekali, terkadang 2 sebutan diatas yaitu Spesifikasi Swagger dan Spesifikasi OpenAPI dipertukarkan.

Akan tetapi mereka adalah 2 istilah yang berbeda karena sejarah.

Spesifikasi Swagger adalah istilah pertama mengenai spesifikasi dokumentasi API.

Spesifikasi Swagger 2.0 merupakan yang terkenal diluncurkan pada tahun 2014.

Kemudian pada tahun 2015, penamaannya berubah dari Spesifikasi Swagger menjadi Spesifikasi OpenAPI, setelah adanya inisiasi untuk membentuk group open source OpenAPI.

Kemudian pada 1 July 2017, group OpenAPI yang didalamnya juga terdapat SmartBear (perusahaan yang memiliki Swagger 2.0) menghasilkan spesifikasi baru, yang disebut Spesifikasi OpenAP1 3.0.0.

Jadi spesifikasi dokumentasi API ini awalnya disebut Spesifikasi Swagger sampai tahun 2015, kemudian diubah menjadi Spesifikasi OpenAPI setelahnya.


Sejarah OpenAPI

Kalau kita lihat sejarahnya dari awal, maka OpenAPI ini diawali dengan kemunculan spesifikasi yang disebut Swagger.

Dimulai dari tahun 2010, oleh Tony Tam yang bekerja di sebuah perusahaan online dictionary.

Bersama dengan kolega dan temannya , kemudian diluncurkanlah spesifikasi untuk dokumentasi API, yang dinamakan spesifikasi Swagger 2.0 pada tahun 2014.

Pada bulan Maret 2015, perusahaan SmartBear mengakuisisi perusahaan diatas, yang secara otomatis juga memiliki hak untuk mempunyai spesifikasi Swagger 2.0 diatas.

Bulan November 2015, perusahaan SmartBear menginisiasi pembentukan group open source OpenAPI dibawah naungan The Linux Foundation.

Tentunya tidak lupa untuk mengajak perusahaan-perusahaan besar lainnya ikut serta didalamnya, seperti Google, Microsoft, IBM, 3scale, dll.

Dan 1 July 2017 group ini menghasilkan spesifikasi baru, hasil dari diskusi dan racikan banyak perusahaan diatas.

Spesifikasi diatas dinamakan spesifikasi OpenAPI 3.0.0.


Lalu swagger kemana ?

Tidak kemana-mana.

SmartBear sebagai perusahaan yang menaungi Swagger, sekarang berfokus kepada merk dagang yang sudah terkenal yaitu Swagger untuk library serta tools yang mengimplementasikan spesifikasi OpenAPI.

Istilahnya mereka bisa lebih fokus kepada membuat implementasinya OpenAPI dan sekaligus menjual tools-tools yang berkaitan.

Misalnya yang merupakan implementasi OpenAPI oleh SmartBear :

  • Swagger Editor
  • Swagger UI
  • Swagger Codegen
  • Swagger parser
  • Swagger Core
  • Swagger Inspector
  • Swagger Hub

OpenAPI merupakan spesifikasi, jadi implementasinya bisa bermacam-macam.

Tidak hanya SmartBear dengan merk dagang swagger nya, akan tetapi ada juga OpenAPI-Delphi, SpringDoc-OpenAPI, Microsoft.OpenAPI.net, dll.

Kita lanjut ke next artikel.