ASP.NET Core API #2: Membuat Project API Pertama dan Menampilkan Hello World

ASP.NET Core API #2: Membuat Project API Pertama dan Menampilkan Hello World

Halo lagi, calon programmer hebat!

Setelah kita siapin semua alat di artikel sebelumnya (kalau belum baca, mending baca dulu biar nggak ketinggalan kereta 🚂), sekarang saatnya kita bikin program pertama kita. Kita akan membuat API yang kalau dipanggil, dia akan bilang "Hello World". Anggap saja ini seperti kita ngajarin komputer untuk menyapa dunia. 🌍

🤣 Kenapa API suka menyapa? Karena dia API (Ayo, Programmer, Ini!) ya nggak sih? 😆

Langkah 1: Membuka Visual Studio 2022

• Klik ikon Visual Studio di desktop atau di start menu. Tunggu sampai muncul jendela Start Window. Di sini kita bisa membuat project baru atau membuka project yang sudah ada.
• Klik tombol Create a new project (buat project baru).

💡 Tips: Kalau jendela start tidak muncul, kamu bisa ke menu File -> New -> Project.

Langkah 2: Memilih Template Project

• Nanti akan muncul daftar template (seperti cetakan kue). Kita pilih yang namanya ASP.NET Core Web API. Template ini sudah disiapin khusus untuk membuat API.
• Ketik di kotak pencarian: web api biar cepat ketemu. Lalu pilih ASP.NET Core Web API dan klik Next.

📝 Pastikan pilih yang C#, bukan Visual Basic. Kita mau pake C# ya.

Langkah 3: Mengisi Nama Project dan Lokasi

• Isi Project name dengan WisataAPI (atau terserah kamu, misal MyFirstAPI).
• Location pilih folder tempat kamu nyimpen project, misal di D:\Projek\ atau di Documents. Yang penting jangan sampai lupa lokasinya.
• Centang Place solution and project in the same directory biar rapi. Lalu klik Next.

Langkah 4: Memilih Framework dan Pengaturan

• Pilih .NET 8.0 (Long Term Support) di dropdown. Ini versi terbaru yang stabil.
• Pastikan Configure for HTTPS dicentang (biar aman kayak pakai helm).
• Enable OpenAPI support biarkan dicentang juga, nanti kita bisa lihat dokumentasi API otomatis. Tapi kalau nggak mau, bisa di-uncek, nggak masalah.
• Jangan lupa Use controllers (biar kita pakai cara klasik yang mudah dipahami). Lalu klik Create.

Visual Studio akan bekerja membuat project. Tunggu sampai selesai, bisa sambil ngemil lagi 🍿.

Langkah 5: Mengenal Isi Project

Setelah project jadi, di sebelah kanan ada jendela Solution Explorer. Isinya kurang lebih seperti ini:

• Controllers – folder tempat kita menaruh file yang mengatur lalu lintas API (seperti polisi lalu lintas).
• appsettings.json – file konfigurasi (seperti catatan kecil).
• Program.cs – file utama yang menjalankan aplikasi.
• WeatherForecast.cs – contoh file model, nanti bisa dihapus.

Kita akan bermain di folder Controllers.

Langkah 6: Membuat Controller Baru

Klik kanan folder Controllers -> Add -> Controller...

Pilih API Controller - Empty (biar kita tulis sendiri). Klik Add.

Beri nama HelloController.cs (atau terserah, misal SalamController). Klik Add.

Langkah 7: Menulis Kode Hello World

Buka file HelloController.cs. Isinya akan seperti ini:

using Microsoft.AspNetCore.Mvc;

namespace WisataAPI.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class HelloController : ControllerBase
    {
        [HttpGet]
        public string Get()
        {
            return "Hello World";
        }
    }
}

Penjelasan singkat:

• [Route("api/[controller]")] – alamat API kita nanti akan dimulai dengan /api/hello (karena nama controller-nya Hello).
• [HttpGet] – artinya method ini akan dijalankan ketika ada permintaan GET (seperti kita minta data).
• public string Get() – method yang mengembalikan teks. Nanti teks "Hello World" akan dikirim ke browser atau Postman.

Simpan file (Ctrl+S).

Langkah 8: Menjalankan API

Klik tombol hijau https di toolbar (biasanya ada nama project dan pilihan browser). Atau tekan F5 untuk menjalankan dengan debugging, atau Ctrl+F5 tanpa debugging.

Visual Studio akan membangun project dan membuka browser default. Biasanya akan muncul halaman error 404 atau halaman Swagger (dokumentasi otomatis). Jangan panik!

Coba lihat di browser, alamatnya kira-kira https://localhost:7000 (portnya bisa berbeda).

Tambahkan /api/hello di belakang alamat tersebut. Misal: https://localhost:7000/api/hello. Maka browser akan menampilkan teks "Hello World".

🔐 Kalau muncul peringatan keamanan karena sertifikat HTTPS, klik Advanced lalu Proceed to localhost. Itu wajar karena kita pakai sertifikat palsu buat development.

Langkah 9: Menguji dengan Postman

Sekarang kita uji dengan Postman. Buka Postman.

1. Klik tab baru (+).
2. Ubah method dari GET (sudah default) menjadi GET (biarkan).
3. Masukkan URL lengkap, misal https://localhost:7000/api/hello (sesuaikan portnya dengan yang muncul di browser tadi).
4. Klik tombol Send.

Di bagian bawah, akan muncul response "Hello World" dengan status 200 OK. Mantap! API pertama kamu berhasil!

💡 Kalau Postman mengeluh "Could not get response", kemungkinan besar API sedang tidak berjalan. Pastikan API masih running di Visual Studio. Jangan ditutup.

Tantangan Sederhana

Coba ubah teks "Hello World" menjadi "Halo, saya suka wisata!" lalu jalankan lagi dan lihat hasilnya di Postman. Selamat, kamu sudah bisa mengedit API! 🎉

Kemudian Coba Buat Controller Baru dibawah ini

1. SukawisataController.cs
2. BiodataController.cs
3. InfosekolahController.cs

jika sudah coba jalankan dan tampilkan Hasilnya

Membersihkan File Contoh

Di project kita ada file contoh WeatherForecast.cs dan WeatherForecastController.cs. Kita bisa hapus karena tidak dipakai. Caranya:

• Klik kanan WeatherForecastController.cs di folder Controllers -> Delete.
• Klik kanan WeatherForecast.cs di root project -> Delete.

Jangan khawatir, API Hello kita tetap aman.

Apa Selanjutnya?

Di artikel berikutnya (ASP.NET Core API #3), kita akan merancang database untuk wisata. Kita akan buat tabel Kategori dan Daftar Wisata di SQL Server. Siapkan SQL Server Management Studio-mu!

😴 Istirahat dulu, jangan lupa minum susu biar tambah tinggi dan tambah pinter ngoding. Sampai jumpa di artikel selanjutnya!

---

Ditulis oleh Kakak programmer yang dulu juga suka main bola. Kalau ada kendala, tulis di komentar ya!

📘 Blog ini akan terus diupdate. Pantengin terus!