Tutorial Dokumentasi API Swagger untuk Pemula - Bagian 1: Pengenalan Dokumentasi API dengan Swagger

Apa itu Swagger?

Tujuan dari Swagger™ adalah untuk mendefinisikan standar antarmuka yang tidak bergantung pada bahasa untuk REST APIs, sehingga manusia dan komputer dapat menemukan dan memahami kemampuan layanan tanpa akses ke kode sumber, dokumentasi, atau bahkan pemeriksaan lalu lintas jaringan. Ketika didefinisikan dengan baik melalui Swagger, seorang konsumen dapat memahami dan berinteraksi dengan layanan jarak jauh dengan jumlah logika implementasi yang minimal. Mirip dengan apa yang dilakukan oleh antarmuka pada level pemrograman yang lebih rendah, Swagger menghilangkan tebakan dalam memanggil layanan.

Secara teknis, Swagger adalah spesifikasi formal yang dikelilingi oleh ekosistem besar alat, yang mencakup segala sesuatu dari antarmuka pengguna frontend, pustaka kode level rendah, hingga solusi manajemen API komersial.

Bagaimana saya memulai?

Jika Anda adalah penyedia API dan ingin menggunakan Swagger untuk mendeskripsikan API Anda, ada beberapa pendekatan yang tersedia:

Pendekatan top-down di mana Anda akan menggunakan Swagger Editor untuk membuat definisi Swagger Anda, lalu menggunakan alat Swagger Codegen yang terintegrasi untuk menghasilkan implementasi server.
Jika