{"openapi":"3.0.3","info":{"title":"Belajar API UNAMA v2","version":"2.0.0","description":"API latihan frontend UNAMA. Dokumentasi: https://belajar-api.unama.ac.id/docs/v2"},"servers":[{"url":"https://belajar-api.unama.ac.id/api/v2"}],"tags":[{"name":"auth","description":"Autentikasi"},{"name":"products","description":"Produk & Kategori"},{"name":"cart","description":"Keranjang, Pesanan & Favorit"},{"name":"todos","description":"Todo List"},{"name":"posts","description":"Blog & Komentar"},{"name":"students","description":"Mahasiswa & Prodi"},{"name":"stats","description":"Statistik & Grafik"},{"name":"quotes","description":"Quotes"},{"name":"playground","description":"Playground HTTP"}],"paths":{"/auth/register":{"post":{"tags":["auth"],"summary":"Registrasi akun baru","description":"Membuat akun baru dan langsung mengembalikan token, jadi user tidak perlu login lagi.","responses":{"201":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Registrasi berhasil","data":{"user":{"name":"Budi Santoso","email":"contoh.egpksn@example.com","phone":"081234567890","updated_at":"2026-10-24T01:25:52.000000Z","created_at":"2026-10-24T01:25:52.000000Z","id":4,"avatar_url":"https://ui-avatars.com/api/?background=random&name=Budi+Santoso"},"token":{"access_token":"9|eUT6rax3VojeCYUgyRFvlSNfXMPzlHxhcQbkwaMETAf68t8n5Jl0b1HpTzF8","token_type":"Bearer","expires_at":"2026-10-31T08:25:52+07:00"}}}}}},"200":{"description":"Berhasil"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nama lengkap (3-100 karakter)","example":"Budi Santoso"},"email":{"type":"string","description":"Email unik","example":"budi@example.com"},"password":{"type":"string","description":"Minimal 6 karakter","example":"rahasia123"},"password_confirmation":{"type":"string","description":"Harus sama dengan password","example":"rahasia123"},"phone":{"type":"string","description":"Nomor HP","example":"081234567890"}},"required":["name","email","password","password_confirmation"]}}}}}},"/auth/login":{"post":{"tags":["auth"],"summary":"Login","description":"Tukar email & password dengan token. Gunakan akun demo `demo@unama.ac.id` / `password` untuk mencoba.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Login berhasil","data":{"user":{"id":4,"name":"Budi Santoso","email":"contoh.egpksn@example.com","phone":"081234567890","bio":null,"avatar":null,"created_at":"2026-10-24T01:25:52.000000Z","updated_at":"2026-10-24T01:25:52.000000Z","avatar_url":"https://ui-avatars.com/api/?background=random&name=Budi+Santoso"},"token":{"access_token":"10|RIkx05PkGtEhJRzYWx0xHCKo7Z0FjG3mlcAzAifo20FQZEGlxnNF3MmZVtpd","token_type":"Bearer","expires_at":"2026-10-31T08:25:52+07:00"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"Email","example":"demo@unama.ac.id"},"password":{"type":"string","description":"Password","example":"password"},"device_name":{"type":"string","description":"Nama perangkat (untuk daftar sesi)","example":"chrome-laptop"},"remember":{"type":"boolean","description":"true = token berlaku 30 hari","example":false}},"required":["email","password"]}}}}}},"/auth/me":{"get":{"tags":["auth"],"summary":"Profil user yang login","description":"Mengembalikan data user pemilik token beserta jumlah todo, pesanan, favorit, dan isi keranjang.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"id":4,"name":"Budi Santoso","email":"contoh.egpksn@example.com","phone":"081234567890","bio":"Belajar frontend setiap hari.","avatar":null,"created_at":"2026-10-24T01:25:52.000000Z","updated_at":"2026-10-24T01:25:57.000000Z","todos_count":0,"orders_count":1,"favorites_count":0,"cart_items_count":0,"avatar_url":"https://ui-avatars.com/api/?background=random&name=Budi+Santoso"}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]},"put":{"tags":["auth"],"summary":"Ubah profil","description":"Kirim hanya field yang ingin diubah. Bisa juga memakai method PATCH.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Profil berhasil diperbarui","data":{"id":4,"name":"Budi Santoso","email":"contoh.egpksn@example.com","phone":"081234567890","bio":"Belajar frontend setiap hari.","avatar":null,"created_at":"2026-10-24T01:25:52.000000Z","updated_at":"2026-10-24T01:25:52.000000Z","avatar_url":"https://ui-avatars.com/api/?background=random&name=Budi+Santoso"}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nama baru","example":"Budi S."},"email":{"type":"string","description":"Email baru (unik)"},"phone":{"type":"string","description":"Nomor HP","example":"089876543210"},"bio":{"type":"string","description":"Bio singkat (maks 500)","example":"Belajar frontend setiap hari."}}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["auth"],"summary":"Hapus akun","description":"Menghapus akun beserta semua datanya. Akun demo tidak bisa dihapus.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Akun berhasil dihapus","data":null}}}},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"password":{"type":"string","description":"Konfirmasi password"}},"required":["password"]}}}},"security":[{"bearerAuth":[]}]}},"/auth/me/avatar":{"post":{"tags":["auth"],"summary":"Upload foto profil","description":"Upload gambar dengan `FormData`. Jangan set header Content-Type secara manual, biarkan browser yang mengisinya.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Foto profil berhasil diunggah","data":{"id":4,"name":"Budi Santoso","email":"contoh.egpksn@example.com","phone":"081234567890","bio":"Belajar frontend setiap hari.","avatar":"/storage/v2/avatars/Npox8qzMfDAqgnO9YUIVuwosGrockZ4RDqkLnK79.png","created_at":"2026-10-24T01:25:52.000000Z","updated_at":"2026-10-24T01:25:52.000000Z","avatar_url":"https://belajar-api.unama.ac.id/storage/v2/avatars/Npox8qzMfDAqgnO9YUIVuwosGrockZ4RDqkLnK79.png"}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"avatar":{"type":"string","description":"Gambar jpg/png/webp, maks 2MB","format":"binary"}},"required":["avatar"]}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["auth"],"summary":"Hapus foto profil","description":"","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Foto profil dihapus","data":{"id":4,"name":"Budi Santoso","email":"contoh.egpksn@example.com","phone":"081234567890","bio":"Belajar frontend setiap hari.","avatar":null,"created_at":"2026-10-24T01:25:52.000000Z","updated_at":"2026-10-24T01:25:53.000000Z","avatar_url":"https://ui-avatars.com/api/?background=random&name=Budi+Santoso"}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/auth/password":{"put":{"tags":["auth"],"summary":"Ganti password","description":"Setelah berhasil, semua token lain milik user dicabut (perangkat lain otomatis logout).","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Password berhasil diubah. Sesi di perangkat lain telah dikeluarkan.","data":null}}}},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"current_password":{"type":"string","description":"Password saat ini","example":"password"},"password":{"type":"string","description":"Password baru (min 6, beda dari lama)","example":"passwordbaru"},"password_confirmation":{"type":"string","description":"Ulangi password baru","example":"passwordbaru"}},"required":["current_password","password","password_confirmation"]}}}},"security":[{"bearerAuth":[]}]}},"/auth/refresh":{"post":{"tags":["auth"],"summary":"Perbarui token","description":"Membuat token baru dan langsung membatalkan token yang sedang dipakai.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Token baru berhasil dibuat, token lama tidak berlaku lagi","data":{"token":{"access_token":"11|SVSgUVQLwClqRRNCiBdm7q063romBwgbDwBx46YjwT9BT63feNZu9g2mACTu","token_type":"Bearer","expires_at":"2026-10-31T08:25:53+07:00"}}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/auth/sessions":{"get":{"tags":["auth"],"summary":"Daftar sesi login","description":"Semua token aktif milik user. `is_current` menandai token yang sedang dipakai.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":9,"name":"web","is_current":false,"last_used_at":null,"expires_at":"2026-10-31T01:25:52.000000Z","created_at":"2026-10-24T01:25:52.000000Z"},{"id":10,"name":"chrome-laptop","is_current":true,"last_used_at":"2026-10-24T01:25:52.000000Z","expires_at":"2026-10-31T01:25:52.000000Z","created_at":"2026-10-24T01:25:52.000000Z"}]}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/auth/logout":{"post":{"tags":["auth"],"summary":"Logout","description":"Mencabut token yang sedang dipakai. Hapus juga token dari localStorage di sisi frontend.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Logout berhasil","data":null}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/auth/logout-all":{"post":{"tags":["auth"],"summary":"Logout dari semua perangkat","description":"","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Berhasil logout dari semua perangkat","data":{"revoked":1}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/categories":{"get":{"tags":["products"],"summary":"Daftar kategori","description":"Semua kategori beserta jumlah produknya (`products_count`).","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":3,"name":"Buku","slug":"buku","description":"Buku pelajaran, novel, dan referensi","icon":"book","created_at":"2026-10-24T01:20:52.000000Z","updated_at":"2026-10-24T01:20:52.000000Z","products_count":7},{"id":1,"name":"Elektronik","slug":"elektronik","description":"Laptop, HP, dan aksesoris gadget","icon":"laptop","created_at":"2026-10-24T01:20:51.000000Z","updated_at":"2026-10-24T01:20:51.000000Z","products_count":7}]}}}}}}},"/categories/{slug}":{"get":{"tags":["products"],"summary":"Detail kategori","description":"","parameters":[{"name":"slug","in":"path","required":true,"description":"Slug atau ID kategori","schema":{"type":"string"},"example":"elektronik"}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"id":1,"name":"Elektronik","slug":"elektronik","description":"Laptop, HP, dan aksesoris gadget","icon":"laptop","created_at":"2026-10-24T01:20:51.000000Z","updated_at":"2026-10-24T01:20:51.000000Z","products_count":7}}}}}}}},"/products":{"get":{"tags":["products"],"summary":"Daftar produk","description":"Mendukung pencarian, filter, sorting, pagination, dan include relasi. Semua parameter bisa digabung.","parameters":[{"name":"q","in":"query","required":false,"description":"Cari di nama, brand, deskripsi","schema":{"type":"string"},"example":"laptop"},{"name":"category","in":"query","required":false,"description":"Slug/ID kategori, bisa lebih dari satu dipisah koma","schema":{"type":"string"},"example":"elektronik,buku"},{"name":"brand","in":"query","required":false,"description":"Filter brand (pisah koma)","schema":{"type":"string"},"example":"Asus"},{"name":"min_price","in":"query","required":false,"description":"Harga minimal","schema":{"type":"integer"},"example":100000},{"name":"max_price","in":"query","required":false,"description":"Harga maksimal","schema":{"type":"integer"},"example":1000000},{"name":"min_rating","in":"query","required":false,"description":"Rating minimal (0-5)","schema":{"type":"number"},"example":4},{"name":"in_stock","in":"query","required":false,"description":"true = hanya yang ada stok, false = yang habis","schema":{"type":"boolean"},"example":true},{"name":"featured","in":"query","required":false,"description":"Hanya produk unggulan","schema":{"type":"boolean"},"example":true},{"name":"discount","in":"query","required":false,"description":"Hanya produk yang sedang diskon","schema":{"type":"boolean"},"example":true},{"name":"sort","in":"query","required":false,"description":"id, name, price, rating, sold, stock, discount_percent, created_at. Awali \"-\" untuk descending","schema":{"type":"string"},"example":"-sold"},{"name":"include","in":"query","required":false,"description":"Sertakan relasi: category, reviews","schema":{"type":"string"},"example":"category"},{"name":"page","in":"query","required":false,"description":"Nomor halaman","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Jumlah data per halaman (1-100)","schema":{"type":"integer"},"example":10}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":24,"category_id":4,"name":"Teh Kayu Aro Premium","slug":"teh-kayu-aro-premium","brand":"Kayu Aro","description":"Teh Kayu Aro Premium merupakan salah satu produk unggulan Kayu Aro yang banyak diminati. Desain modern dan ringkas, cocok untuk mahasiswa maupun pekerja. Cocok dijadikan hadiah untuk keluarga atau tem...","price":45000,"discount_percent":25,"stock":75,"rating":4.4,"sold":2459,"image":"https://picsum.photos/seed/teh-kayu-aro-premium/600/600","is_featured":true,"created_at":"2026-10-24T01:20:52.000000Z","updated_at":"2026-10-24T01:20:52.000000Z","final_price":33750,"in_stock":true,"category":{"id":4,"name":"Makanan & Minuman","slug":"makanan-minuman","description":"Camilan, kopi, dan oleh-oleh khas","icon":"coffee","created_at":"2026-10-24T01:20:52.000000Z","updated_at":"2026-10-24T01:20:52.000000Z"}},{"id":29,"category_id":5,"name":"Rice Cooker Digital 1.8L","slug":"rice-cooker-digital-18l","brand":"Miyako","description":"Dapatkan Rice Cooker Digital 1.8L original dari Miyako dengan kualitas terbaik. Desain modern dan ringkas, cocok untuk mahasiswa maupun pekerja. Cocok dijadikan hadiah untuk keluarga atau teman. Harga...","price":449000,"discount_percent":5,"stock":25,"rating":4.4,"sold":2423,"image":"https://picsum.photos/seed/rice-cooker-digital-18l/600/600","is_featured":false,"created_at":"2026-10-24T01:20:52.000000Z","updated_at":"2026-10-24T01:20:52.000000Z","final_price":426550,"in_stock":true,"category":{"id":5,"name":"Rumah Tangga","slug":"rumah-tangga","description":"Perlengkapan rumah dan dapur","icon":"home","created_at":"2026-10-24T01:20:52.000000Z","updated_at":"2026-10-24T01:20:52.000000Z"}}],"meta":{"current_page":1,"per_page":4,"total":42,"last_page":11,"from":1,"to":4},"links":{"first":"https://belajar-api.unama.ac.id/api/v2/products?include=category&sort=-sold&per_page=4&page=1","last":"https://belajar-api.unama.ac.id/api/v2/products?include=category&sort=-sold&per_page=4&page=11","prev":null,"next":"https://belajar-api.unama.ac.id/api/v2/products?include=category&sort=-sold&per_page=4&page=2"}}}}}}}},"/products/brands":{"get":{"tags":["products"],"summary":"Daftar brand","description":"Untuk mengisi pilihan filter brand (checkbox/dropdown).","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"brand":"Alexandre Christie","products_count":1,"final_price":0,"in_stock":false},{"brand":"Andi Offset","products_count":1,"final_price":0,"in_stock":false}]}}}}}}},"/products/{id}":{"get":{"tags":["products"],"summary":"Detail produk","description":"Termasuk kategori, jumlah ulasan, `rating_breakdown` (jumlah per bintang), dan 4 produk `related`.","parameters":[{"name":"id","in":"path","required":true,"description":"ID atau slug produk","schema":{"type":"string"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"id":1,"category_id":1,"name":"Laptop Pro 14 inci Ryzen 7","slug":"laptop-pro-14-inci-ryzen-7","brand":"Asus","description":"Laptop Pro 14 inci Ryzen 7 merupakan salah satu produk unggulan Asus yang banyak diminati. Desain modern dan ringkas, cocok untuk mahasiswa maupun pekerja. Bergaransi resmi dan sudah melalui pengeceka...","price":12999000,"discount_percent":0,"stock":0,"rating":4.6,"sold":222,"image":"https://picsum.photos/seed/laptop-pro-14-inci-ryzen-7/600/600","is_featured":false,"created_at":"2026-10-24T01:20:52.000000Z","updated_at":"2026-10-24T01:20:52.000000Z","reviews_count":5,"rating_breakdown":{"5":3,"4":2,"3":0,"2":0,"1":0},"related":[{"id":6,"category_id":1,"name":"Monitor 24 inci IPS 75Hz","slug":"monitor-24-inci-ips-75hz","brand":"LG","description":"Monitor 24 inci IPS 75Hz dari LG hadir untuk memenuhi kebutuhan Anda sehari-hari. Mudah digunakan bahkan untuk pemula. Desain modern dan ringkas, cocok untuk mahasiswa maupun pekerja. Dikemas dengan a...","price":1899000,"discount_percent":0,"stock":25,"rating":4,"sold":893,"image":"https://picsum.photos/seed/monitor-24-inci-ips-75hz/600/600","is_featured":true,"created_at":"2026-10-24T01:20:52.000000Z","updated_at":"2026-10-24T01:20:52.000000Z","final_price":1899000,"in_stock":true},{"id":5,"category_id":1,"name":"Keyboard Mekanikal 75%","slug":"keyboard-mekanikal-75","brand":"Rexus","description":"Keyboard Mekanikal 75% dari Rexus hadir untuk memenuhi kebutuhan Anda sehari-hari. Bergaransi resmi dan sudah melalui pengecekan kualitas. Cocok dijadikan hadiah untuk keluarga atau teman. Harga bersa...","price":689000,"discount_percent":5,"stock":0,"rating":4.2,"sold":809,"image":"https://picsum.photos/seed/keyboard-mekanikal-75/600/600","is_featured":false,"created_at":"2026-10-24T01:20:52.000000Z","updated_at":"2026-10-24T01:20:52.000000Z","final_price":654550,"in_stock":false}],"final_price":12999000,"in_stock":false,"category":{"id":1,"name":"Elektronik","slug":"elektronik","description":"Laptop, HP, dan aksesoris gadget","icon":"laptop","created_at":"2026-10-24T01:20:51.000000Z","updated_at":"2026-10-24T01:20:51.000000Z"}}}}}}}}},"/products/{id}/reviews":{"get":{"tags":["products"],"summary":"Ulasan produk","description":"","parameters":[{"name":"id","in":"path","required":true,"description":"ID atau slug produk","schema":{"type":"string"},"example":1},{"name":"rating","in":"query","required":false,"description":"Filter bintang 1-5","schema":{"type":"integer"},"example":5},{"name":"sort","in":"query","required":false,"description":"latest (default) atau oldest","schema":{"type":"string"},"example":"latest"},{"name":"page","in":"query","required":false,"description":"Nomor halaman","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Jumlah data per halaman (1-100)","schema":{"type":"integer"},"example":10}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":1,"product_id":1,"user_id":null,"reviewer_name":"Wawan Rajasa","rating":5,"comment":"Kurang sesuai ekspektasi, tapi masih bisa dipakai.","created_at":"2026-09-21T19:58:22.000000Z","updated_at":"2026-10-24T01:20:52.000000Z"},{"id":3,"product_id":1,"user_id":null,"reviewer_name":"Paramita Riyanti","rating":4,"comment":"Lumayan, tapi pengiriman agak lama.","created_at":"2026-09-15T09:33:46.000000Z","updated_at":"2026-10-24T01:20:52.000000Z"}],"meta":{"current_page":1,"per_page":5,"total":5,"last_page":1,"from":1,"to":5,"average_rating":4.6},"links":{"first":"https://belajar-api.unama.ac.id/api/v2/products/1/reviews?page=1","last":"https://belajar-api.unama.ac.id/api/v2/products/1/reviews?page=1","prev":null,"next":null}}}}}}},"post":{"tags":["products"],"summary":"Beri ulasan","description":"Satu user hanya punya satu ulasan per produk. Mengirim lagi akan memperbarui ulasan sebelumnya.","parameters":[{"name":"id","in":"path","required":true,"description":"ID atau slug produk","schema":{"type":"string"},"example":1}],"responses":{"201":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Ulasan berhasil ditambahkan","data":{"product_id":3,"user_id":4,"rating":5,"comment":"Barang bagus, pengiriman cepat!","reviewer_name":"Budi Santoso","updated_at":"2026-10-24T01:25:56.000000Z","created_at":"2026-10-24T01:25:56.000000Z","id":225}}}}},"200":{"description":"Berhasil"},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rating":{"type":"integer","description":"Bintang 1-5","example":5},"comment":{"type":"string","description":"Isi ulasan","example":"Barang bagus, pengiriman cepat!"}},"required":["rating"]}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["products"],"summary":"Hapus ulasan saya","description":"","parameters":[{"name":"id","in":"path","required":true,"description":"ID atau slug produk","schema":{"type":"string"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Ulasan dihapus","data":null}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/cart":{"get":{"tags":["cart"],"summary":"Isi keranjang","description":"Daftar item beserta `subtotal`, `shipping_cost`, `total`, dan `total_items` (untuk badge di ikon keranjang).","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"items":[{"id":9,"user_id":4,"product_id":3,"quantity":2,"created_at":"2026-10-24T01:25:54.000000Z","updated_at":"2026-10-24T01:25:54.000000Z","subtotal":1438200,"product":{"id":3,"name":"Earbuds TWS Noise Cancelling","slug":"earbuds-tws-noise-cancelling","price":799000,"discount_percent":10,"stock":120,"image":"https://picsum.photos/seed/earbuds-tws-noise-cancelling/600/600","final_price":719100,"in_stock":true}},{"id":10,"user_id":4,"product_id":9,"quantity":2,"created_at":"2026-10-24T01:25:54.000000Z","updated_at":"2026-10-24T01:25:54.000000Z","subtotal":126400,"product":{"id":9,"name":"Kaos Polos Cotton Combed 30s","slug":"kaos-polos-cotton-combed-30s","price":79000,"discount_percent":20,"stock":75,"image":"https://picsum.photos/seed/kaos-polos-cotton-combed-30s/600/600","final_price":63200,"in_stock":true}}],"total_items":4,"subtotal":1564600,"shipping_cost":0,"total":1564600,"free_shipping_min":500000}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["cart"],"summary":"Kosongkan keranjang","description":"","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Keranjang dikosongkan","data":{"items":[],"total_items":0,"subtotal":0,"shipping_cost":0,"total":0,"free_shipping_min":500000}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/cart/items":{"post":{"tags":["cart"],"summary":"Tambah ke keranjang","description":"Jika produk sudah ada di keranjang, jumlahnya ditambahkan. Gagal (422) jika melebihi stok.","responses":{"201":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Produk ditambahkan ke keranjang","data":{"items":[{"id":9,"user_id":4,"product_id":3,"quantity":1,"created_at":"2026-10-24T01:25:54.000000Z","updated_at":"2026-10-24T01:25:54.000000Z","subtotal":719100,"product":{"id":3,"name":"Earbuds TWS Noise Cancelling","slug":"earbuds-tws-noise-cancelling","price":799000,"discount_percent":10,"stock":120,"image":"https://picsum.photos/seed/earbuds-tws-noise-cancelling/600/600","final_price":719100,"in_stock":true}}],"total_items":1,"subtotal":719100,"shipping_cost":0,"total":719100,"free_shipping_min":500000}}}}},"200":{"description":"Berhasil"},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"integer","description":"ID produk","example":1},"quantity":{"type":"integer","description":"Jumlah (default 1)","example":1}},"required":["product_id"]}}}},"security":[{"bearerAuth":[]}]}},"/cart/items/{id}":{"patch":{"tags":["cart"],"summary":"Ubah jumlah item","description":"","parameters":[{"name":"id","in":"path","required":true,"description":"ID item keranjang (bukan ID produk)","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Jumlah item diperbarui","data":{"items":[{"id":9,"user_id":4,"product_id":3,"quantity":2,"created_at":"2026-10-24T01:25:54.000000Z","updated_at":"2026-10-24T01:25:54.000000Z","subtotal":1438200,"product":{"id":3,"name":"Earbuds TWS Noise Cancelling","slug":"earbuds-tws-noise-cancelling","price":799000,"discount_percent":10,"stock":120,"image":"https://picsum.photos/seed/earbuds-tws-noise-cancelling/600/600","final_price":719100,"in_stock":true}},{"id":10,"user_id":4,"product_id":9,"quantity":2,"created_at":"2026-10-24T01:25:54.000000Z","updated_at":"2026-10-24T01:25:54.000000Z","subtotal":126400,"product":{"id":9,"name":"Kaos Polos Cotton Combed 30s","slug":"kaos-polos-cotton-combed-30s","price":79000,"discount_percent":20,"stock":75,"image":"https://picsum.photos/seed/kaos-polos-cotton-combed-30s/600/600","final_price":63200,"in_stock":true}}],"total_items":4,"subtotal":1564600,"shipping_cost":0,"total":1564600,"free_shipping_min":500000}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quantity":{"type":"integer","description":"Jumlah baru","example":2}},"required":["quantity"]}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["cart"],"summary":"Hapus item","description":"","parameters":[{"name":"id","in":"path","required":true,"description":"ID item keranjang","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Item dihapus dari keranjang","data":{"items":[{"id":10,"user_id":4,"product_id":9,"quantity":2,"created_at":"2026-10-24T01:25:54.000000Z","updated_at":"2026-10-24T01:25:54.000000Z","subtotal":126400,"product":{"id":9,"name":"Kaos Polos Cotton Combed 30s","slug":"kaos-polos-cotton-combed-30s","price":79000,"discount_percent":20,"stock":75,"image":"https://picsum.photos/seed/kaos-polos-cotton-combed-30s/600/600","final_price":63200,"in_stock":true}}],"total_items":2,"subtotal":126400,"shipping_cost":15000,"total":141400,"free_shipping_min":500000}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/orders":{"post":{"tags":["cart"],"summary":"Checkout","description":"Mengubah seluruh isi keranjang menjadi pesanan, lalu keranjang dikosongkan. Metode `cod` langsung berstatus `paid`, lainnya `pending`.","responses":{"201":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Pesanan berhasil dibuat","data":{"recipient_name":"Budi Santoso","phone":"081234567890","address":"Jl. Sumantri Brojonegoro No. 1, Kota Jambi","payment_method":"transfer","note":"Tolong dibungkus rapi","code":"INV/20261024/B2SVH7","status":"pending","paid_at":null,"subtotal":782300,"shipping_cost":0,"total":782300,"user_id":4,"updated_at":"2026-10-24T01:25:55.000000Z","created_at":"2026-10-24T01:25:55.000000Z","id":3,"items":[{"id":5,"order_id":3,"product_id":3,"product_name":"Earbuds TWS Noise Cancelling","price":719100,"quantity":1,"subtotal":719100,"created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z"},{"id":6,"order_id":3,"product_id":9,"product_name":"Kaos Polos Cotton Combed 30s","price":63200,"quantity":1,"subtotal":63200,"created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z"}]}}}}},"200":{"description":"Berhasil"},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipient_name":{"type":"string","description":"Nama penerima","example":"Budi Santoso"},"phone":{"type":"string","description":"No. HP penerima","example":"081234567890"},"address":{"type":"string","description":"Alamat lengkap (min 10 karakter)","example":"Jl. Sumantri Brojonegoro No. 1, Kota Jambi"},"payment_method":{"type":"string","description":"transfer, cod, atau ewallet","example":"transfer"},"note":{"type":"string","description":"Catatan untuk penjual","example":"Tolong dibungkus rapi"}},"required":["recipient_name","phone","address","payment_method"]}}}},"security":[{"bearerAuth":[]}]},"get":{"tags":["cart"],"summary":"Riwayat pesanan","description":"","parameters":[{"name":"status","in":"query","required":false,"description":"pending, paid, shipped, completed, cancelled (pisah koma)","schema":{"type":"string"},"example":"pending,paid"},{"name":"sort","in":"query","required":false,"description":"id, total, created_at","schema":{"type":"string"},"example":"-created_at"},{"name":"page","in":"query","required":false,"description":"Nomor halaman","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Jumlah data per halaman (1-100)","schema":{"type":"integer"},"example":10}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":3,"user_id":4,"code":"INV/20261024/B2SVH7","status":"pending","subtotal":782300,"shipping_cost":0,"total":782300,"recipient_name":"Budi Santoso","phone":"081234567890","address":"Jl. Sumantri Brojonegoro No. 1, Kota Jambi","payment_method":"transfer","note":"Tolong dibungkus rapi","paid_at":null,"created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z","items_count":2}],"meta":{"current_page":1,"per_page":10,"total":1,"last_page":1,"from":1,"to":1},"links":{"first":"https://belajar-api.unama.ac.id/api/v2/orders?page=1","last":"https://belajar-api.unama.ac.id/api/v2/orders?page=1","prev":null,"next":null}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/orders/{id}":{"get":{"tags":["cart"],"summary":"Detail pesanan","description":"","parameters":[{"name":"id","in":"path","required":true,"description":"ID pesanan","schema":{"type":"string"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"id":3,"user_id":4,"code":"INV/20261024/B2SVH7","status":"pending","subtotal":782300,"shipping_cost":0,"total":782300,"recipient_name":"Budi Santoso","phone":"081234567890","address":"Jl. Sumantri Brojonegoro No. 1, Kota Jambi","payment_method":"transfer","note":"Tolong dibungkus rapi","paid_at":null,"created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z","items":[{"id":5,"order_id":3,"product_id":3,"product_name":"Earbuds TWS Noise Cancelling","price":719100,"quantity":1,"subtotal":719100,"created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z"},{"id":6,"order_id":3,"product_id":9,"product_name":"Kaos Polos Cotton Combed 30s","price":63200,"quantity":1,"subtotal":63200,"created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z"}]}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/orders/{id}/pay":{"post":{"tags":["cart"],"summary":"Bayar pesanan (simulasi)","description":"Ubah status `pending` → `paid`. Status lain menghasilkan 409 Conflict.","parameters":[{"name":"id","in":"path","required":true,"description":"ID pesanan","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Pembayaran berhasil (simulasi)","data":{"id":3,"user_id":4,"code":"INV/20261024/B2SVH7","status":"paid","subtotal":782300,"shipping_cost":0,"total":782300,"recipient_name":"Budi Santoso","phone":"081234567890","address":"Jl. Sumantri Brojonegoro No. 1, Kota Jambi","payment_method":"transfer","note":"Tolong dibungkus rapi","paid_at":"2026-10-24T01:25:55.000000Z","created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z","items":[{"id":5,"order_id":3,"product_id":3,"product_name":"Earbuds TWS Noise Cancelling","price":719100,"quantity":1,"subtotal":719100,"created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z"},{"id":6,"order_id":3,"product_id":9,"product_name":"Kaos Polos Cotton Combed 30s","price":63200,"quantity":1,"subtotal":63200,"created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z"}]}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/orders/{id}/cancel":{"post":{"tags":["cart"],"summary":"Batalkan pesanan","description":"","parameters":[{"name":"id","in":"path","required":true,"description":"ID pesanan","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Pesanan dibatalkan","data":{"id":3,"user_id":4,"code":"INV/20261024/B2SVH7","status":"cancelled","subtotal":782300,"shipping_cost":0,"total":782300,"recipient_name":"Budi Santoso","phone":"081234567890","address":"Jl. Sumantri Brojonegoro No. 1, Kota Jambi","payment_method":"transfer","note":"Tolong dibungkus rapi","paid_at":"2026-10-24T01:25:55.000000Z","created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z","items":[{"id":5,"order_id":3,"product_id":3,"product_name":"Earbuds TWS Noise Cancelling","price":719100,"quantity":1,"subtotal":719100,"created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z"},{"id":6,"order_id":3,"product_id":9,"product_name":"Kaos Polos Cotton Combed 30s","price":63200,"quantity":1,"subtotal":63200,"created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z"}]}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/favorites":{"get":{"tags":["cart"],"summary":"Daftar produk favorit","description":"","parameters":[{"name":"page","in":"query","required":false,"description":"Nomor halaman","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Jumlah data per halaman (1-100)","schema":{"type":"integer"},"example":10}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":3,"category_id":1,"name":"Earbuds TWS Noise Cancelling","slug":"earbuds-tws-noise-cancelling","brand":"Xiaomi","description":"Earbuds TWS Noise Cancelling dari Xiaomi hadir untuk memenuhi kebutuhan Anda sehari-hari. Dibuat dari material berkualitas sehingga awet dan tahan lama. Cocok dijadikan hadiah untuk keluarga atau tema...","price":799000,"discount_percent":10,"stock":120,"rating":3.5,"sold":634,"image":"https://picsum.photos/seed/earbuds-tws-noise-cancelling/600/600","is_featured":false,"created_at":"2026-10-24T01:20:52.000000Z","updated_at":"2026-10-24T01:22:39.000000Z","final_price":719100,"in_stock":true,"category":{"id":1,"name":"Elektronik","slug":"elektronik"},"pivot":{"user_id":4,"product_id":3,"created_at":"2026-10-24T01:25:55.000000Z","updated_at":"2026-10-24T01:25:55.000000Z"}}],"meta":{"current_page":1,"per_page":12,"total":1,"last_page":1,"from":1,"to":1},"links":{"first":"https://belajar-api.unama.ac.id/api/v2/favorites?page=1","last":"https://belajar-api.unama.ac.id/api/v2/favorites?page=1","prev":null,"next":null}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/favorites/{productId}":{"post":{"tags":["cart"],"summary":"Tambah favorit","description":"Aman dipanggil berkali-kali (idempotent).","parameters":[{"name":"productId","in":"path","required":true,"description":"ID produk","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Ditambahkan ke favorit","data":{"product_id":3,"is_favorite":true}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["cart"],"summary":"Hapus favorit","description":"","parameters":[{"name":"productId","in":"path","required":true,"description":"ID produk","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Dihapus dari favorit","data":{"product_id":3,"is_favorite":false}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/todos":{"get":{"tags":["todos"],"summary":"Daftar todo","description":"","parameters":[{"name":"completed","in":"query","required":false,"description":"true = selesai, false = belum","schema":{"type":"boolean"},"example":false},{"name":"priority","in":"query","required":false,"description":"low, medium, high (pisah koma)","schema":{"type":"string"},"example":"high"},{"name":"q","in":"query","required":false,"description":"Cari judul","schema":{"type":"string"},"example":"belajar"},{"name":"overdue","in":"query","required":false,"description":"Hanya yang lewat tenggat","schema":{"type":"boolean"},"example":true},{"name":"sort","in":"query","required":false,"description":"id, title, priority, due_date, completed, created_at","schema":{"type":"string"},"example":"due_date"},{"name":"page","in":"query","required":false,"description":"Nomor halaman","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Jumlah data per halaman (1-100)","schema":{"type":"integer"},"example":10}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":6,"user_id":4,"title":"Membuat halaman login","description":null,"completed":false,"priority":"medium","due_date":null,"created_at":"2026-10-24T01:25:53.000000Z","updated_at":"2026-10-24T01:25:53.000000Z"},{"id":5,"user_id":4,"title":"Belajar fetch API","description":"Coba GET, POST, PUT, DELETE","completed":false,"priority":"high","due_date":"2026-10-31","created_at":"2026-10-24T01:25:53.000000Z","updated_at":"2026-10-24T01:25:53.000000Z"}],"meta":{"current_page":1,"per_page":10,"total":2,"last_page":1,"from":1,"to":2},"links":{"first":"https://belajar-api.unama.ac.id/api/v2/todos?page=1","last":"https://belajar-api.unama.ac.id/api/v2/todos?page=1","prev":null,"next":null}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]},"post":{"tags":["todos"],"summary":"Tambah todo","description":"","responses":{"201":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Todo berhasil ditambahkan","data":{"id":5,"user_id":4,"title":"Belajar fetch API","description":"Coba GET, POST, PUT, DELETE","completed":false,"priority":"high","due_date":"2026-10-31","created_at":"2026-10-24T01:25:53.000000Z","updated_at":"2026-10-24T01:25:53.000000Z"}}}}},"200":{"description":"Berhasil"},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"Judul (3-255 karakter)","example":"Belajar fetch API"},"description":{"type":"string","description":"Keterangan","example":"Coba GET, POST, PUT, DELETE"},"priority":{"type":"string","description":"low, medium (default), high","example":"high"},"due_date":{"type":"string","description":"Tenggat, format YYYY-MM-DD","example":"2026-12-31"},"completed":{"type":"boolean","description":"Default false","example":false}},"required":["title"]}}}},"security":[{"bearerAuth":[]}]}},"/todos/stats":{"get":{"tags":["todos"],"summary":"Statistik todo","description":"Jumlah total, selesai, belum, terlambat, dan per prioritas. Cocok untuk progress bar.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"total":2,"completed":1,"pending":1,"overdue":0,"by_priority":{"low":1,"medium":1}}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/todos/{id}":{"get":{"tags":["todos"],"summary":"Detail todo","description":"","parameters":[{"name":"id","in":"path","required":true,"description":"ID todo","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"id":5,"user_id":4,"title":"Belajar fetch API","description":"Coba GET, POST, PUT, DELETE","completed":false,"priority":"high","due_date":"2026-10-31","created_at":"2026-10-24T01:25:53.000000Z","updated_at":"2026-10-24T01:25:53.000000Z"}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]},"put":{"tags":["todos"],"summary":"Ubah todo (PUT)","description":"PUT = kirim data lengkap (`title` wajib). Untuk mengubah sebagian field saja, gunakan PATCH ke URL yang sama.","parameters":[{"name":"id","in":"path","required":true,"description":"ID todo","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Todo berhasil diperbarui","data":{"id":5,"user_id":4,"title":"Belajar fetch API (revisi)","description":"Coba GET, POST, PUT, DELETE","completed":false,"priority":"medium","due_date":"2026-10-31","created_at":"2026-10-24T01:25:53.000000Z","updated_at":"2026-10-24T01:25:53.000000Z"}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"Judul","example":"Belajar fetch API (revisi)"},"description":{"type":"string","description":"Keterangan"},"priority":{"type":"string","description":"low, medium, high","example":"medium"},"due_date":{"type":"string","description":"YYYY-MM-DD"},"completed":{"type":"boolean","description":"Status selesai","example":true}},"required":["title"]}}}},"security":[{"bearerAuth":[]}]},"patch":{"tags":["todos"],"summary":"Ubah sebagian (PATCH)","description":"","parameters":[{"name":"id","in":"path","required":true,"description":"ID todo","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Todo berhasil diperbarui","data":{"id":5,"user_id":4,"title":"Belajar fetch API (revisi)","description":"Coba GET, POST, PUT, DELETE","completed":false,"priority":"low","due_date":"2026-10-31","created_at":"2026-10-24T01:25:53.000000Z","updated_at":"2026-10-24T01:25:53.000000Z"}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"priority":{"type":"string","description":"Contoh: hanya ubah prioritas","example":"low"}}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["todos"],"summary":"Hapus todo","description":"","parameters":[{"name":"id","in":"path","required":true,"description":"ID todo","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Todo berhasil dihapus","data":null}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/todos/{id}/toggle":{"patch":{"tags":["todos"],"summary":"Centang / batal centang","description":"Membalik nilai `completed` tanpa perlu mengirim body.","parameters":[{"name":"id","in":"path","required":true,"description":"ID todo","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Todo ditandai selesai","data":{"id":5,"user_id":4,"title":"Belajar fetch API (revisi)","description":"Coba GET, POST, PUT, DELETE","completed":true,"priority":"low","due_date":"2026-10-31","created_at":"2026-10-24T01:25:53.000000Z","updated_at":"2026-10-24T01:25:53.000000Z"}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/todos/completed":{"delete":{"tags":["todos"],"summary":"Hapus semua yang selesai","description":"","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"1 todo selesai berhasil dihapus","data":{"deleted":1}}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/posts":{"get":{"tags":["posts"],"summary":"Daftar artikel","description":"Tambahkan `paginate=cursor` untuk mode infinite scroll: ambil halaman berikutnya dengan `links.next` atau `cursor={meta.next_cursor}` sampai `meta.has_more` bernilai false.","parameters":[{"name":"q","in":"query","required":false,"description":"Cari judul/ringkasan","schema":{"type":"string"},"example":"api"},{"name":"category","in":"query","required":false,"description":"Kategori artikel","schema":{"type":"string"},"example":"JavaScript"},{"name":"tag","in":"query","required":false,"description":"Filter tag","schema":{"type":"string"},"example":"react"},{"name":"paginate","in":"query","required":false,"description":"Isi \"cursor\" untuk cursor pagination","schema":{"type":"string"},"example":"cursor"},{"name":"cursor","in":"query","required":false,"description":"Nilai meta.next_cursor dari response sebelumnya","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"id, title, views, likes, published_at (mode halaman saja)","schema":{"type":"string"},"example":"-views"},{"name":"page","in":"query","required":false,"description":"Nomor halaman","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Jumlah data per halaman (1-100)","schema":{"type":"integer"},"example":10}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":30,"title":"Belajar Mandiri: Cara Konsisten Ngoding Setiap Hari","slug":"belajar-mandiri-cara-konsisten-ngoding-setiap-hari","excerpt":"Artikel ini membahas belajar Mandiri: Cara Konsisten Ngoding Setiap Hari. Topik ini berkaitan erat dengan karier dan sangat berguna untuk Anda yang sedang belajar menjadi developer.","cover":"https://picsum.photos/seed/post-belajar-mandiri-cara-konsisten-ngoding-setiap-hari/1200/630","author_name":"Dalima Haryanti","category":"Karier","tags":["karier"],"views":7759,"likes":33,"published_at":"2026-10-23T01:00:00.000000Z","comments_count":2},{"id":29,"title":"Deploy Website Statis Gratis","slug":"deploy-website-statis-gratis","excerpt":"Artikel ini membahas deploy Website Statis Gratis. Topik ini berkaitan erat dengan tools dan sangat berguna untuk Anda yang sedang belajar menjadi developer.","cover":"https://picsum.photos/seed/post-deploy-website-statis-gratis/1200/630","author_name":"Melinda Zahra Nasyidah","category":"Tools","tags":["tools"],"views":1335,"likes":261,"published_at":"2026-10-22T01:00:00.000000Z","comments_count":5}],"meta":{"per_page":3,"has_more":true,"next_cursor":"eyJwdWJsaXNoZWRfYXQiOiIyMDI2LTEwLTIxIDA4OjAwOjAwIiwiaWQiOjI4LCJfcG9pbnRzVG9OZXh0SXRlbXMiOnRydWV9","prev_cursor":null},"links":{"next":"https://belajar-api.unama.ac.id/api/v2/posts?paginate=cursor&per_page=3&cursor=eyJwdWJsaXNoZWRfYXQiOiIyMDI2LTEwLTIxIDA4OjAwOjAwIiwiaWQiOjI4LCJfcG9pbnRzVG9OZXh0SXRlbXMiOnRydWV9","prev":null}}}}}}}},"/posts/categories":{"get":{"tags":["posts"],"summary":"Kategori artikel","description":"","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"category":"Backend","posts_count":5},{"category":"Frontend","posts_count":5}]}}}}}}},"/posts/tags":{"get":{"tags":["posts"],"summary":"Daftar tag","description":"Diurutkan dari yang paling banyak dipakai. Cocok untuk tag cloud.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"tag":"api","posts_count":10},{"tag":"javascript","posts_count":7}]}}}}}}},"/posts/{slug}":{"get":{"tags":["posts"],"summary":"Detail artikel","description":"Isi `body` berupa HTML. `views` bertambah setiap dibuka. Ada `prev` dan `next` untuk navigasi antar artikel.","parameters":[{"name":"slug","in":"path","required":true,"description":"Slug atau ID artikel","schema":{"type":"string"},"example":"cara-mengambil-data-dari-api-dengan-fetch"}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"id":4,"title":"Cara Mengambil Data dari API dengan Fetch","slug":"cara-mengambil-data-dari-api-dengan-fetch","excerpt":"Artikel ini membahas cara Mengambil Data dari API dengan Fetch. Topik ini berkaitan erat dengan javascript, api dan sangat berguna untuk Anda yang sedang belajar menjadi developer.","body":"<p>Artikel ini membahas cara Mengambil Data dari API dengan Fetch. Topik ini berkaitan erat dengan javascript, api dan sangat berguna untuk Anda yang sedang belajar menjadi developer.</p><p>Setelah be...","cover":"https://picsum.photos/seed/post-cara-mengambil-data-dari-api-dengan-fetch/1200/630","author_name":"Digdaya Salahudin S.Farm","category":"JavaScript","tags":["javascript","api"],"views":8503,"likes":315,"published_at":"2026-09-27T01:00:00.000000Z","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:22:28.000000Z","comments_count":2,"prev":{"id":3,"title":"Memahami Promise dan Async/Await dengan Mudah","slug":"memahami-promise-dan-asyncawait-dengan-mudah"},"next":{"id":5,"title":"Axios vs Fetch: Perbandingan Lengkap","slug":"axios-vs-fetch-perbandingan-lengkap"}}}}}}}}},"/posts/{slug}/like":{"post":{"tags":["posts"],"summary":"Sukai artikel","description":"Tanpa login. Latihan optimistic update: tambah angka like di UI dulu, baru kirim request.","parameters":[{"name":"slug","in":"path","required":true,"description":"Slug atau ID artikel","schema":{"type":"string"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Terima kasih sudah menyukai artikel ini","data":{"id":1,"likes":14}}}}}}}},"/posts/{slug}/comments":{"get":{"tags":["posts"],"summary":"Komentar artikel","description":"","parameters":[{"name":"slug","in":"path","required":true,"description":"Slug atau ID artikel","schema":{"type":"string"},"example":1},{"name":"page","in":"query","required":false,"description":"Nomor halaman","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Jumlah data per halaman (1-100)","schema":{"type":"integer"},"example":10}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":2,"post_id":1,"user_id":null,"name":"Betania Zulaika S.IP","body":"Akhirnya paham juga, makasih.","created_at":"2026-10-06T05:00:00.000000Z","updated_at":"2026-10-24T01:20:53.000000Z"},{"id":5,"post_id":1,"user_id":null,"name":"Gaiman Edi Tampubolon S.Psi","body":"Penjelasannya mudah dipahami.","created_at":"2026-10-06T00:00:00.000000Z","updated_at":"2026-10-24T01:20:53.000000Z"}],"meta":{"current_page":1,"per_page":10,"total":6,"last_page":1,"from":1,"to":6},"links":{"first":"https://belajar-api.unama.ac.id/api/v2/posts/1/comments?page=1","last":"https://belajar-api.unama.ac.id/api/v2/posts/1/comments?page=1","prev":null,"next":null}}}}}}},"post":{"tags":["posts"],"summary":"Kirim komentar","description":"","parameters":[{"name":"slug","in":"path","required":true,"description":"Slug atau ID artikel","schema":{"type":"string"},"example":1}],"responses":{"201":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Komentar berhasil dikirim","data":{"body":"Artikelnya sangat membantu!","user_id":4,"name":"Budi Santoso","post_id":1,"updated_at":"2026-10-24T01:25:56.000000Z","created_at":"2026-10-24T01:25:56.000000Z","id":92}}}}},"200":{"description":"Berhasil"},"401":{"description":"Token tidak ada / tidak valid"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"body":{"type":"string","description":"Isi komentar (2-1000 karakter)","example":"Artikelnya sangat membantu!"}},"required":["body"]}}}},"security":[{"bearerAuth":[]}]}},"/comments/{id}":{"delete":{"tags":["posts"],"summary":"Hapus komentar sendiri","description":"Menghasilkan 403 jika komentar milik orang lain.","parameters":[{"name":"id","in":"path","required":true,"description":"ID komentar","schema":{"type":"integer"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Komentar dihapus","data":null}}}},"401":{"description":"Token tidak ada / tidak valid"}},"security":[{"bearerAuth":[]}]}},"/students":{"get":{"tags":["students"],"summary":"Daftar mahasiswa","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Cari nama atau NIM","schema":{"type":"string"},"example":"putri"},{"name":"prodi","in":"query","required":false,"description":"Kode prodi: TI, SI, SK, MI, MN, AK (pisah koma)","schema":{"type":"string"},"example":"TI,SI"},{"name":"status","in":"query","required":false,"description":"aktif, cuti, lulus, non-aktif","schema":{"type":"string"},"example":"aktif"},{"name":"gender","in":"query","required":false,"description":"L atau P","schema":{"type":"string"},"example":"P"},{"name":"entry_year","in":"query","required":false,"description":"Tahun masuk (pisah koma)","schema":{"type":"string"},"example":"2024,2025"},{"name":"city","in":"query","required":false,"description":"Kota asal","schema":{"type":"string"},"example":"Jambi"},{"name":"min_gpa","in":"query","required":false,"description":"IPK minimal","schema":{"type":"number"},"example":3.5},{"name":"max_gpa","in":"query","required":false,"description":"IPK maksimal","schema":{"type":"number"},"example":4},{"name":"sort","in":"query","required":false,"description":"id, nim, name, gpa, entry_year, semester, birth_date","schema":{"type":"string"},"example":"-gpa"},{"name":"page","in":"query","required":false,"description":"Nomor halaman","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Jumlah data per halaman (1-100)","schema":{"type":"integer"},"example":10}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":106,"nim":"20TI0106","name":"Teddy Gaduh Irawan S.Gz","email":"20ti0106@student.unama.ac.id","gender":"L","birth_date":"2002-11-28","city":"Jambi","study_program_id":1,"entry_year":2020,"semester":13,"gpa":3.99,"status":"lulus","photo":"https://i.pravatar.cc/300?u=20TI0106","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z","study_program":{"id":1,"code":"TI","name":"Teknik Informatika","degree":"S1"}},{"id":34,"nim":"19TI0034","name":"Marsudi Suryono","email":"19ti0034@student.unama.ac.id","gender":"L","birth_date":"2002-10-28","city":"Kerinci","study_program_id":1,"entry_year":2019,"semester":14,"gpa":3.99,"status":"non-aktif","photo":"https://i.pravatar.cc/300?u=19TI0034","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z","study_program":{"id":1,"code":"TI","name":"Teknik Informatika","degree":"S1"}}],"meta":{"current_page":1,"per_page":5,"total":45,"last_page":9,"from":1,"to":5},"links":{"first":"https://belajar-api.unama.ac.id/api/v2/students?prodi=TI&sort=-gpa&per_page=5&page=1","last":"https://belajar-api.unama.ac.id/api/v2/students?prodi=TI&sort=-gpa&per_page=5&page=9","prev":null,"next":"https://belajar-api.unama.ac.id/api/v2/students?prodi=TI&sort=-gpa&per_page=5&page=2"}}}}}}}},"/students/{nim}":{"get":{"tags":["students"],"summary":"Detail mahasiswa","description":"","parameters":[{"name":"nim","in":"path","required":true,"description":"NIM atau ID","schema":{"type":"string"},"example":1}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"id":1,"nim":"19MI0001","name":"Cici Oktaviani","email":"19mi0001@student.unama.ac.id","gender":"P","birth_date":"2002-04-23","city":"Merangin","study_program_id":4,"entry_year":2019,"semester":14,"gpa":3.01,"status":"lulus","photo":"https://i.pravatar.cc/300?u=19MI0001","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z","study_program":{"id":4,"code":"MI","name":"Manajemen Informatika","faculty":"Fakultas Ilmu Komputer","degree":"D3","accreditation":"Baik","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z"}}}}}}}}},"/study-programs":{"get":{"tags":["students"],"summary":"Daftar program studi","description":"Termasuk jumlah mahasiswa dan rata-rata IPK tiap prodi.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":6,"code":"AK","name":"Akuntansi","faculty":"Fakultas Ekonomi dan Bisnis","degree":"S1","accreditation":"Baik","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z","students_count":23,"students_avg_gpa":"3.176087"},{"id":4,"code":"MI","name":"Manajemen Informatika","faculty":"Fakultas Ilmu Komputer","degree":"D3","accreditation":"Baik","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z","students_count":13,"students_avg_gpa":"3.421538"}]}}}}}}},"/study-programs/{code}":{"get":{"tags":["students"],"summary":"Detail program studi","description":"","parameters":[{"name":"code","in":"path","required":true,"description":"Kode prodi","schema":{"type":"string"},"example":"TI"}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"id":1,"code":"TI","name":"Teknik Informatika","faculty":"Fakultas Ilmu Komputer","degree":"S1","accreditation":"Baik Sekali","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z","students_count":45,"students_avg_gpa":"3.312222"}}}}}}}},"/stats/summary":{"get":{"tags":["stats"],"summary":"Ringkasan dashboard","description":"Angka-angka untuk kartu ringkasan di dashboard.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"products":42,"categories":6,"posts":30,"students":150,"active_students":96,"average_gpa":3.29,"total_stock":1009,"total_sold":50827}}}}}}}},"/stats/sales-monthly":{"get":{"tags":["stats"],"summary":"Penjualan bulanan","description":"Data dummy per bulan untuk grafik garis/batang. Hasilnya selalu sama untuk tahun yang sama.","parameters":[{"name":"year","in":"query","required":false,"description":"Tahun 2020 s.d. sekarang","schema":{"type":"integer"},"example":2025}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"year":2026,"labels":["Jan","Feb"],"series":[{"month":1,"label":"Jan","orders":191,"revenue":28268000,"visitors":4584},{"month":2,"label":"Feb","orders":128,"revenue":28416000,"visitors":3712}],"total_revenue":407503000,"total_orders":2233}}}}}}}},"/stats/students-by-program":{"get":{"tags":["stats"],"summary":"Mahasiswa per prodi","description":"Cocok untuk pie/doughnut chart.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"labels":["TI","SI"],"values":[45,41],"details":[{"id":1,"code":"TI","name":"Teknik Informatika","faculty":"Fakultas Ilmu Komputer","degree":"S1","accreditation":"Baik Sekali","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z","students_count":45},{"id":2,"code":"SI","name":"Sistem Informasi","faculty":"Fakultas Ilmu Komputer","degree":"S1","accreditation":"Baik Sekali","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z","students_count":41}]}}}}}}}},"/stats/students-by-year":{"get":{"tags":["stats"],"summary":"Mahasiswa per angkatan","description":"Dengan rincian laki-laki & perempuan (stacked bar chart).","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"entry_year":2019,"total":16,"male":11,"female":5},{"entry_year":2020,"total":14,"male":8,"female":6}]}}}}}}},"/stats/students-by-status":{"get":{"tags":["stats"],"summary":"Mahasiswa per status","description":"","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"labels":["lulus","aktif"],"values":[25,96]}}}}}}}},"/stats/products-by-category":{"get":{"tags":["stats"],"summary":"Produk per kategori","description":"","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"labels":["Buku","Elektronik"],"values":[7,7],"details":[{"id":3,"name":"Buku","slug":"buku","description":"Buku pelajaran, novel, dan referensi","icon":"book","created_at":"2026-10-24T01:20:52.000000Z","updated_at":"2026-10-24T01:20:52.000000Z","products_count":7,"products_sum_sold":"9511"},{"id":1,"name":"Elektronik","slug":"elektronik","description":"Laptop, HP, dan aksesoris gadget","icon":"laptop","created_at":"2026-10-24T01:20:51.000000Z","updated_at":"2026-10-24T01:20:51.000000Z","products_count":7,"products_sum_sold":"5566"}]}}}}}}}},"/stats/top-products":{"get":{"tags":["stats"],"summary":"Produk terlaris","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Jumlah data (1-20)","schema":{"type":"integer"},"example":5}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":24,"name":"Teh Kayu Aro Premium","slug":"teh-kayu-aro-premium","sold":2459,"price":45000,"discount_percent":25,"image":"https://picsum.photos/seed/teh-kayu-aro-premium/600/600","rating":4.4,"final_price":33750,"in_stock":false},{"id":29,"name":"Rice Cooker Digital 1.8L","slug":"rice-cooker-digital-18l","sold":2423,"price":449000,"discount_percent":5,"image":"https://picsum.photos/seed/rice-cooker-digital-18l/600/600","rating":4.4,"final_price":426550,"in_stock":false}]}}}}}}},"/quotes":{"get":{"tags":["quotes"],"summary":"Daftar quotes","description":"","parameters":[{"name":"category","in":"query","required":false,"description":"programming, motivation, education, design, life","schema":{"type":"string"},"example":"programming"},{"name":"author","in":"query","required":false,"description":"Cari nama tokoh","schema":{"type":"string"},"example":"Jobs"},{"name":"page","in":"query","required":false,"description":"Nomor halaman","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Jumlah data per halaman (1-100)","schema":{"type":"integer"},"example":10}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":[{"id":1,"text":"Talk is cheap. Show me the code.","author":"Linus Torvalds","category":"programming","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z"},{"id":2,"text":"Programs must be written for people to read, and only incidentally for machines to execute.","author":"Harold Abelson","category":"programming","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z"}],"meta":{"current_page":1,"per_page":10,"total":25,"last_page":3,"from":1,"to":10},"links":{"first":"https://belajar-api.unama.ac.id/api/v2/quotes?page=1","last":"https://belajar-api.unama.ac.id/api/v2/quotes?page=3","prev":null,"next":"https://belajar-api.unama.ac.id/api/v2/quotes?page=2"}}}}}}}},"/quotes/random":{"get":{"tags":["quotes"],"summary":"Quote acak","description":"Hasil berbeda setiap request. Cocok untuk tombol \"Quote lain\".","parameters":[{"name":"category","in":"query","required":false,"description":"Filter kategori","schema":{"type":"string"}}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"id":9,"text":"Experience is the name everyone gives to their mistakes.","author":"Oscar Wilde","category":"life","created_at":"2026-10-24T01:20:53.000000Z","updated_at":"2026-10-24T01:20:53.000000Z"}}}}}}}},"/playground/echo":{"post":{"tags":["playground"],"summary":"Echo request","description":"Mengembalikan method, query, body, file, dan header yang Anda kirim. Menerima semua method (GET/POST/PUT/PATCH/DELETE). Sangat berguna untuk mengecek apakah request sudah terbentuk dengan benar.","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Echo dari server","data":{"method":"POST","url":"https://belajar-api.unama.ac.id/api/v2/playground/echo?debug=1","query":{"debug":"1"},"body":{"nama":"Budi","hobi":["ngoding"]},"files":[],"content_type":"application/json","headers":{"authorization":"Bearer 11|SVSgUVQLwClqRRNCiBdm7q063romBwgbDwBx46YjwT9BT63feNZu9g2mACTu","accept":"application/json","content-type":"application/json","user-agent":"GuzzleHttp/7","host":"belajar-api.unama.ac.id"},"ip":"127.0.0.1"}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"apa_saja":{"type":"string","description":"Kirim field apa pun","example":"halo"}}}}}}}},"/playground/delay/{ms}":{"get":{"tags":["playground"],"summary":"Respon lambat","description":"Server menunggu sekian milidetik sebelum menjawab (maks 5000). Latihan spinner/skeleton loading dan AbortController.","parameters":[{"name":"ms","in":"path","required":true,"description":"Lama tunggu dalam milidetik","schema":{"type":"integer"},"example":2000}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Respon tertunda 2000 ms","data":{"delay_ms":2000,"time":"2026-10-24T08:25:51+07:00"}}}}}}}},"/playground/status/{code}":{"get":{"tags":["playground"],"summary":"Paksa status HTTP","description":"Mengembalikan kode status pilihan (200, 201, 204, 400, 401, 403, 404, 409, 422, 429, 500, 503, dll). Ingat: `fetch` tidak melempar error untuk 4xx/5xx, cek `response.ok`!","parameters":[{"name":"code","in":"path","required":true,"description":"Kode status HTTP","schema":{"type":"integer"},"example":404}],"responses":{"404":{"description":"Contoh response","content":{"application/json":{"example":{"success":false,"message":"404 Not Found","data":{"status":404}}}}},"200":{"description":"Berhasil"}}}},"/playground/random":{"get":{"tags":["playground"],"summary":"Gagal secara acak","description":"Kadang berhasil, kadang 500. Latihan membuat tombol \"Coba lagi\" atau retry otomatis.","parameters":[{"name":"fail_rate","in":"query","required":false,"description":"Peluang gagal dalam persen (0-100)","schema":{"type":"integer"},"example":50}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"Berhasil!","data":{"lucky_number":744}}}}}}}},"/playground/headers":{"get":{"tags":["playground"],"summary":"Lihat header request","description":"","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"accept":"application/json","user-agent":"GuzzleHttp/7","host":"belajar-api.unama.ac.id","content-length":"","content-type":""}}}}}}}},"/playground/uuid":{"get":{"tags":["playground"],"summary":"Generate UUID","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"Jumlah (1-50)","schema":{"type":"integer"},"example":3}],"responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":["d4989a59-227d-4327-9fff-691eae202c0c"]}}}}}}},"/playground/time":{"get":{"tags":["playground"],"summary":"Waktu server (WIB)","description":"","responses":{"200":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"OK","data":{"iso":"2026-10-24T08:25:52+07:00","timestamp":1792805152,"date":"2026-10-24","time":"08:25:52","day":"Sabtu","timezone":"Asia/Jakarta"}}}}}}}},"/playground/validate":{"post":{"tags":["playground"],"summary":"Latihan validasi form","description":"Tidak menyimpan apa pun. Kirim data yang salah untuk melihat format error 422, lalu tampilkan pesan `errors` di bawah tiap input.","responses":{"422":{"description":"Contoh response","content":{"application/json":{"example":{"success":false,"message":"Data yang dikirim tidak valid","errors":{"name":["Nama minimal berisi 3 karakter."],"email":["Surel harus berupa alamat surel yang valid."],"age":["Usia harus bernilai antara 17 sampai 100."],"gender":["Jenis kelamin yang dipilih tidak valid."],"password":["Kata sandi minimal berisi 8 karakter.","Password harus mengandung minimal 1 huruf besar dan 1 angka."],"agree":["Agree harus diterima."]}}}}},"200":{"description":"Berhasil"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"3-50 karakter","example":"Budi"},"email":{"type":"string","description":"Format email","example":"budi@example.com"},"age":{"type":"integer","description":"17-100","example":20},"website":{"type":"string","description":"URL valid","example":"https://budi.dev"},"gender":{"type":"string","description":"L atau P","example":"L"},"hobbies":{"type":"array","description":"Maks 5 item","example":["ngoding","membaca"]},"birth_date":{"type":"string","description":"YYYY-MM-DD, sebelum hari ini","example":"2004-05-17"},"password":{"type":"string","description":"Min 8, ada huruf besar & angka","example":"Rahasia123"},"password_confirmation":{"type":"string","description":"Sama dengan password","example":"Rahasia123"},"agree":{"type":"boolean","description":"Harus true (centang syarat & ketentuan)","example":true}},"required":["name","email","age","gender","password","password_confirmation","agree"]}}}}}},"/playground/upload":{"post":{"tags":["playground"],"summary":"Upload satu file","description":"Kirim dengan `FormData`. Maks 2MB (jpg, png, gif, webp, pdf, txt). Cocok untuk latihan preview gambar & progress bar upload.","responses":{"201":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"File berhasil diunggah","data":{"original_name":"user.png","size":43361,"mime_type":"image/png","description":"Foto KTM","url":"https://belajar-api.unama.ac.id/storage/v2/uploads/20261024/QsZHqca5j6bNfUSutCSh59lua6tku51usNHDP36J.png"}}}}},"200":{"description":"Berhasil"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","description":"File yang diunggah","format":"binary"},"description":{"type":"string","description":"Keterangan","example":"Foto KTM"}},"required":["file"]}}}}}},"/playground/upload-multiple":{"post":{"tags":["playground"],"summary":"Upload banyak file","description":"Maks 5 file. Di FormData gunakan nama field `files[]` untuk setiap file.","responses":{"201":{"description":"Contoh response","content":{"application/json":{"example":{"success":true,"message":"2 file berhasil diunggah","data":[{"original_name":"user.png","size":43361,"url":"https://belajar-api.unama.ac.id/storage/v2/uploads/20261024/dfhqITkVdkn8cv10b00ze5yx4yGeIh7qFxCN2DkA.png"},{"original_name":"robots.txt","size":24,"url":"https://belajar-api.unama.ac.id/storage/v2/uploads/20261024/spcE1RCUgfSZkF6PzAFuzpmHYYtlgsngriP5otBy.txt"}]}}}},"200":{"description":"Berhasil"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"files[]":{"type":"string","description":"Beberapa file sekaligus","format":"binary"}},"required":["files[]"]}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}