Seri 8 bagian: belajar mendesain REST API dengan pendekatan spec-first di Go - menulis kontrak OpenAPI dulu, generate kode, lalu terapkan ke project hexagonal architecture nyata.
Pengenalan seri OpenAPI Spec-First untuk Go Developer - apa itu OpenAPI, kenapa spec-first lebih enak dibanding nulis dokumentasi API belakangan, dan apa yang akan kita bangun sepanjang seri ini.
Membedah bagian-bagian file OpenAPI YAML satu per satu - info, servers, paths, parameters, requestBody, responses, dan components/schemas - sambil menulis spec Notes API dari nol.
Perbandingan tools OpenAPI yang populer di ekosistem Go - oapi-codegen, swaggo/swag, dan go-swagger - serta kapan masing-masing cocok dipakai.
Menjalankan oapi-codegen sungguhan terhadap notes-api.yaml, membedah kode yang dihasilkan, mengimplementasikan handler, dan menguji semua endpoint Notes API lewat curl.
Melint OpenAPI spec dengan Redocly CLI untuk menangkap masalah sebelum jadi kode, lalu serve dokumentasi interaktif Swagger UI langsung dari server Go yang sama.
Pindah dari contoh standalone ke project hexagonal architecture nyata - membedah konvensi spec OpenAPI yang sudah dipakai di boilerplate, lalu menulis product-api.yaml mengikuti pola yang sama.
Generate kode dari product-api.yaml lalu membangun seluruh lapis hexagonal architecture untuk Product - domain, port, service, repository, sampai handler yang implement ServerInterface hasil generate.
Menjalankan migration, menyalakan server, dan menguji seluruh endpoint Product API lewat PostgreSQL sungguhan - menutup seri OpenAPI Spec-First untuk Go Developer dengan siklus penuh dari YAML sampai database.