ASP.NET Core API #5: Membuat CRUD untuk Kategori Wisata (GET, POST, PUT, DELETE)

byFerdian Rahabista -
0

ASP.NET Core API #5: Membuat CRUD untuk Kategori Wisata (GET, POST, PUT, DELETE)

Halo lagi, calon programmer super! 👋

Di artikel sebelumnya kita sudah bisa menghubungkan API dengan database dan mengambil data kategori. Tapi kita baru bisa membaca data (GET). Sekarang kita akan buat API yang bisa menambah, mengubah, dan menghapus data. Di dunia programming, operasi ini disebut CRUD: Create (buat), Read (baca), Update (ubah), Delete (hapus).

🤣 Kenapa CRUD disebut CRUD? Karena kalau kita salah ngoding, bisa crud (kasar) sendiri! 😅

Kita akan fokus ke Kategori Wisata dulu. Kita akan buat endpoint-endpoint berikut:

  • GET /api/kategori – ambil semua kategori (udah ada).
  • GET /api/kategori/{id} – ambil satu kategori berdasarkan id (udah ada).
  • POST /api/kategori – tambah kategori baru.
  • PUT /api/kategori/{id} – ubah data kategori yang sudah ada.
  • DELETE /api/kategori/{id} – hapus kategori.

Langkah 1: Buka Controller Kategori

Buka project WisataAPI di Visual Studio. Cari file KategoriController.cs di folder Controllers. Kita akan tambahkan method-method baru di dalam class ini.

Sekarang isi file KategoriController.cs kita seperti ini (setelah ditambahkan semua method):

using Microsoft.AspNetCore.Mvc;
using Microsoft.EntityFrameworkCore;
using WisataAPI.Data;
using WisataAPI.Models;

namespace WisataAPI.Controllers
{
    [Route("api/[controller]")]
    [ApiController]
    public class KategoriController : ControllerBase
    {
        private readonly WisataDbContext _context;

        public KategoriController(WisataDbContext context)
        {
            _context = context;
        }

        // GET: api/kategori
        [HttpGet]
        public async Task<ActionResult<IEnumerable<KategoriWisata>>> GetKategori()
        {
            return await _context.KategoriWisata.ToListAsync();
        }

        // GET: api/kategori/5
        [HttpGet("{id}")]
        public async Task<ActionResult<KategoriWisata>> GetKategori(int id)
        {
            var kategori = await _context.KategoriWisata.FindAsync(id);

            if (kategori == null)
            {
                return NotFound();
            }

            return kategori;
        }

        // POST: api/kategori
        [HttpPost]
        public async Task<ActionResult<KategoriWisata>> PostKategori(KategoriWisata kategori)
        {
            _context.KategoriWisata.Add(kategori);
            await _context.SaveChangesAsync();

            return CreatedAtAction(nameof(GetKategori), new { id = kategori.Id }, kategori);
        }

        // PUT: api/kategori/5
        [HttpPut("{id}")]
        public async Task<IActionResult> PutKategori(int id, KategoriWisata kategori)
        {
            if (id != kategori.Id)
            {
                return BadRequest();
            }

            _context.Entry(kategori).State = EntityState.Modified;

            try
            {
                await _context.SaveChangesAsync();
            }
            catch (DbUpdateConcurrencyException)
            {
                if (!KategoriExists(id))
                {
                    return NotFound();
                }
                else
                {
                    throw;
                }
            }

            return NoContent();
        }

        // DELETE: api/kategori/5
        [HttpDelete("{id}")]
        public async Task<IActionResult> DeleteKategori(int id)
        {
            var kategori = await _context.KategoriWisata.FindAsync(id);
            if (kategori == null)
            {
                return NotFound();
            }

            _context.KategoriWisata.Remove(kategori);
            await _context.SaveChangesAsync();

            return NoContent();
        }

        private bool KategoriExists(int id)
        {
            return _context.KategoriWisata.Any(e => e.Id == id);
        }
    }
}

Wah, panjang ya! Tapi tenang, kita bahas satu per satu.

Langkah 2: POST – Menambah Kategori Baru

Method PostKategori bertugas menerima data kategori baru dari client (Postman) dan menyimpannya ke database.

[HttpPost]
public async Task<ActionResult<KategoriWisata>> PostKategori(KategoriWisata kategori)
{
    _context.KategoriWisata.Add(kategori);
    await _context.SaveChangesAsync();

    return CreatedAtAction(nameof(GetKategori), new { id = kategori.Id }, kategori);
}

Penjelasan:

  • [HttpPost] – method ini akan dipanggil kalau ada request POST ke /api/kategori.
  • KategoriWisata kategori – data kategori dikirim dalam body request (format JSON). EF Core akan secara otomatis mengisi properti dari JSON.
  • _context.KategoriWisata.Add(kategori) – memberitahu EF bahwa kita ingin menambah data baru. Data ini belum masuk database, masih di memory.
  • await _context.SaveChangesAsync() – perintah untuk menyimpan perubahan ke database. Baru di sini data benar-benar tersimpan.
  • return CreatedAtAction(...) – mengembalikan response status 201 Created beserta lokasi data baru (biasanya di header Location) dan data yang baru dibuat.

Uji POST di Postman

  1. Jalankan API (F5).
  2. Buka Postman, buat request baru.
  3. Ubah method menjadi POST.
  4. Masukkan URL: https://localhost:7000/api/kategori (sesuaikan port).
  5. Pilih tab Body, pilih raw, dan pilih JSON.
  6. Ketik data baru, misalnya: 
    {
    "nama": "Taman Hiburan",
    "deskripsi": "Tempat bermain dan wahana seru"
}
  7. Klik Send.

Kalau berhasil, response status 201 Created dan data yang dikirim akan kembali dengan id yang baru (misal id 4). Cek juga di database atau panggil GET all untuk memastikan data masuk.

💡 Id tidak perlu dikirim karena di database sudah auto-increment. Kalau kamu kirim Id, akan diabaikan atau malah error.

Langkah 3: PUT – Mengubah Kategori

Method PutKategori digunakan untuk mengupdate data kategori yang sudah ada.

[HttpPut("{id}")]
public async Task<IActionResult> PutKategori(int id, KategoriWisata kategori)
{
    if (id != kategori.Id)
    {
        return BadRequest();
    }

    _context.Entry(kategori).State = EntityState.Modified;

    try
    {
        await _context.SaveChangesAsync();
    }
    catch (DbUpdateConcurrencyException)
    {
        if (!KategoriExists(id))
        {
            return NotFound();
        }
        else
        {
            throw;
        }
    }

    return NoContent();
}

Penjelasan:

  • [HttpPut("{id}")] – request PUT ke /api/kategori/3 akan memanggil method ini dengan parameter id = 3.
  • if (id != kategori.Id) – memastikan id di URL sama dengan id di body data. Kalau beda, kita anggap request salah (BadRequest).
  • _context.Entry(kategori).State = EntityState.Modified; – memberitahu EF bahwa data ini sudah diubah. Nanti pas SaveChangesAsync, EF akan meng-generate SQL UPDATE.
  • try-catch – menangani kemungkinan data sudah dihapus atau diubah orang lain (konkurensi). Kalau data tidak ada, kita kembalikan NotFound.
  • return NoContent(); – kalau sukses, kembalikan status 204 No Content. Biasanya PUT tidak perlu mengembalikan data.

Uji PUT di Postman

  1. Di Postman, buat request baru, method PUT.
  2. URL: https://localhost:7000/api/kategori/4 (ganti id dengan id yang baru ditambahkan).
  3. Body raw JSON, misalnya ubah deskripsi: 
    {
    "id": 4,
    "nama": "Taman Hiburan",
    "deskripsi": "Tempat bermain, wahana seru, dan konser"
}
  4. Klik Send.

Response yang diharapkan: status 204 No Content. Kemudian cek dengan GET untuk memastikan perubahan tersimpan.

Langkah 4: DELETE – Menghapus Kategori

Method DeleteKategori untuk menghapus data berdasarkan id.

[HttpDelete("{id}")]
public async Task<IActionResult> DeleteKategori(int id)
{
    var kategori = await _context.KategoriWisata.FindAsync(id);
    if (kategori == null)
    {
        return NotFound();
    }

    _context.KategoriWisata.Remove(kategori);
    await _context.SaveChangesAsync();

    return NoContent();
}

Penjelasan:

  • FindAsync(id) – cari data di database.
  • Kalau tidak ada, kembalikan 404 NotFound.
  • Remove(kategori) – hapus dari memory (EF akan menandai untuk dihapus).
  • SaveChangesAsync() – eksekusi penghapusan.
  • Kembalikan 204 No Content.

Uji DELETE di Postman

  1. Buat request baru, method DELETE.
  2. URL: https://localhost:7000/api/kategori/4 (ganti id yang ingin dihapus).
  3. Klik Send.

Response: 204 No Content. Coba GET lagi, data dengan id tersebut sudah hilang.

⚠️ Hati-hati menghapus kategori yang masih memiliki data wisata! Di database kita, relasi foreign key akan mencegah penghapusan kalau masih ada daftar wisata yang mengacu ke kategori itu. Nanti di artikel selanjutnya kita akan bahas penanganannya (cascade delete atau hapus manual).

Langkah 5: Uji Semua Endpoint

Sekarang kita punya 5 endpoint yang bekerja. Coba urutkan pengujian:

  1. GET /api/kategori – lihat data awal.
  2. POST – tambah data baru, misal "Taman Hiburan".
  3. GET /api/kategori/{id} – cek data yang baru.
  4. PUT – ubah data tersebut.
  5. DELETE – hapus data tersebut.
  6. GET lagi untuk memastikan data benar-benar terhapus.
📝 Catatan: Di Postman, kamu bisa menyimpan request-request ini dalam koleksi (collection) biar gampang dipakai lagi. Kasih nama "WisataAPI".

Error yang Mungkin Muncul

  • 500 Internal Server Error – biasanya karena koneksi database bermasalah atau ada exception di kode. Cek pesan errornya di Visual Studio (Output window).
  • 400 Bad Request – data yang dikirim tidak sesuai, misal id tidak cocok, atau validasi model gagal (misal nama kosong).
  • 404 Not Found – data dengan id tersebut tidak ditemukan.
  • 409 Conflict – mungkin karena ada duplikat atau constraint database.

Selamat! Kamu Sudah Bisa CRUD!

Sekarang API-mu sudah bisa melakukan operasi dasar terhadap data kategori. Kamu bisa menambah, melihat, mengubah, dan menghapus kategori wisata.

Di artikel selanjutnya (ASP.NET Core API #6), kita akan membuat CRUD untuk Daftar Wisata. Kita akan belajar bagaimana menangani relasi dengan kategori, dan mungkin menambahkan validasi yang lebih canggih. Sampai jumpa!

😎 Kalau ada yang error, jangan marah-marah. Anggap saja bug itu teman yang ngajarin kita buat lebih teliti. Semangat!

Ditulis oleh Kakak programmer yang dulu juga sering lupa titik koma. Kalau ada pertanyaan, tulis di komentar ya!

📘 Blog ini akan terus diupdate. Pantengin terus!
Tags

Anda mungkin menyukai postingan ini

Lebih baru Lebih lama

نموذج الاتصال