ANALISIS DAN PERANCANGAN SISTEM Pada bab ini menjelaskan tahap analisis dan perancangan
3.2.7 Perancangan Antarmuka Pemrograman Aplikasi Pada subbab ini akan dibahas secara terperinci mengenai Pada subbab ini akan dibahas secara terperinci mengenai
3.2.7.1.8 Perancangan Modul Notifikasi
Pada perancangan API modul notifikasi terdapat dua komponen modul sebagai berikut:
1. Modul Memasukkan Token FCM (POST /fcm/token/submit)
Modul ini digunakan untuk memasukkan token FCM yang telah didapatkan kedalam basis data di server. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.90. Hasil response body berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.91.
2. Modul Mengubah Status Login ketika Logout
(POST /fcm/token/logout)
Modul ini digunakan untuk mengubah status login
pengguna ketika pengguna melakukan logout, sehingga notifikasi tidak lagi dikirimkan ke pengguna yang telah melakukan logout. Klien akan mengirimkan request
dengan komposisi data pada Tabel 3.92. Hasil response body berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.93.
3.2.7.1.9 Perancangan Modul Blok
Pada perancangan API modul blok terdapat tiga komponen modul sebagai berikut:
1. Modul Memblok Pengguna (POST /bids/block)
Modul ini digunakan oleh pengguna sebagai pelelang untuk melakukan blok terhadap pengguna lain sebagai penawar pada suatu sesi lelang. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.94. Hasil response body berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.95.
2. Modul Membebaskan Pengguna (POST /bids/unblock)
Modul ini digunakan oleh pengguna sebagai pelelang untuk membebaskan pengguna lain sebagai penawar yang telah di blok. Klien akan mengirimkan request
dengan komposisi data pada Tabel 3.96. Hasil response body berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.97.
3. Modul Mendapatkan Daftar Blok
(GET /bids/block/item/:itemId/bidtime/:bidTime/list) Modul ini digunakan untuk mendapatkan daftar penawar yang telah di blok oleh pelelang dalam suatu sesi lelang. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.98. Hasil response body
berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.99 dan 3.100.
3.2.7.1.10 Perancangan Modul Pilih Pemenang
Pada perancangan API modul pilih pemenang terdapat satu komponen modul sebagai berikut:
1. Modul Memilih Pemenang Lelang (POST /bids/select/winner)
Modul ini digunakan untuk memilih pemenang lelang setelah waktu lelang telah usai. Klien akan mengirimkan
request dengan komposisi data pada Tabel 3.101. Hasil
response body berupa dokumen JSON dengan
komposisi data dapat dilihat pada Tabel 3.102.
3.2.7.1.11 Perancangan Modul Validasi Token
Pada perancangan API modul validasi token terdapat satu komponen modul sebagai berikut:
1. Modul Melakukan Validasi Token (GET /validation/token)
Modul ini digunakan untuk melakukan validasi token saat pengguna yang telah melakukan login membuka perangkat lunak Lelangapa. Klien akan mengirimkan
request dengan komposisi data pada Tabel 3.103. Hasil
response body berupa dokumen JSON dengan
komposisi data dapat dilihat pada Tabel 3.104.
3.2.7.2 Perancangan API Publik
Pada subbab ini akan dibahas secara terperinci mengenai rancangan antarmuka pemrograman aplikasi bersifat publik untuk perangkat lunak Lelangapa. API yang bersifat publik tidak perlu menyertakan token untuk mengaksesnya. Berikut detail perancangan API akses publik untuk perangkat lunak Lelangapa.
3.2.7.2.1 Modul Item
Pada perancangan API modul item terdapat satu komponen modul sebagai berikut:
1. Modul Mendapatkan Daftar Barang (GET /public/users/:userId/items)
Modul ini digunakan untuk mendapatkan daftar barang yang dilelang milik pengguna lain. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.105. Hasil response body berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.106 dan 3.107.
3.2.7.2.2 Modul User
Pada perancangan API modul user terdapat tiga komponen modul sebagai berikut:
1. Modul Login
(POST /public/users/login)
Modul ini digunakan untuk melakukan login akun pengguna. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.108. Hasil response body
berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.109 dan 3.110.
2. Modul Register
(POST /public/users/register)
Modul ini digunakan untuk melakukan registrasi akun baru. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.111. Hasil response body
berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.112.
3. Modul Melakukan Validasi Input Username
(GET /public/checker/username/:username)
Modul ini digunakan untuk memeriksa apakah
username yang akan dibuat sudah ada yang
menggunakan. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.113. Hasil response body
berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.114.
4. Modul Melakukan Validasi Input Domain
(GET /public/checker/domain/:domain)
Modul ini digunakan untuk memeriksa apakah domain yang akan dibuat sudah ada yang menggunakan. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.115. Hasil response body berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.116.
3.2.7.2.3 Modul Feedback
Pada perancangan API modul user terdapat empat komponen modul sebagai berikut:
1. Modul Mendapatkan Daftar Ulasan sebagai Pemenang (GET /public/users/:userId/ratings/as/winner)
Modul ini digunakan untuk mendapatkan daftar ulasan sebagai pemenang pada pengguna lain. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.117. Hasil response body berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.118 dan 3.119.
2. Modul Mendapatkan Daftar Ulasan sebagai Pelelang (GET /public/users/:userId/ratings/as/auctioneer) Modul ini digunakan untuk mendapatkan daftar ulasan sebagai pelelang pada pengguna lain. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.120. Hasil response body berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.121 dan 3.122.
3. Modul Mendapatkan Rata-Rata Ulasan sebagai Pemenang
(GET /public/users/:userId/ratings/as/winner/average) Modul ini digunakan untuk mendapatkan rata-rata ulasan sebagai pemenang pada pengguna lain. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.123. Hasil response body berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.124.
4. Modul Mendapatkan Rata-Rata Ulasan sebagai Pelelang (GET
/public/users/:userId/ratings/as/auctioneer/average) Modul ini digunakan untuk mendapatkan rata-rata ulasan sebagai pelelang pada pengguna lain. Klien akan mengirimkan request dengan komposisi data pada Tabel 3.125. Hasil response body berupa dokumen JSON dengan komposisi data dapat dilihat pada Tabel 3.126.