https://github.com/yanuarprayoga9/submission-bookshelf-api
dicoding backend pemula
https://github.com/yanuarprayoga9/submission-bookshelf-api
dicoding-submission hapijs nodejs
Last synced: 5 months ago
JSON representation
dicoding backend pemula
- Host: GitHub
- URL: https://github.com/yanuarprayoga9/submission-bookshelf-api
- Owner: Yanuarprayoga9
- Created: 2023-07-21T03:28:29.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-07-21T03:49:06.000Z (about 2 years ago)
- Last Synced: 2025-05-13T02:12:37.191Z (5 months ago)
- Topics: dicoding-submission, hapijs, nodejs
- Language: JavaScript
- Homepage:
- Size: 4.13 MB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# npm run start-dev
# npm run start
Terdapat 7 kriteria utama yang harus Anda penuhi dalam membuat proyek Bookshelf API.
# Kriteria 1 : Aplikasi menggunakan port 9000 || compeleted
# Kriteria 2 : Aplikasi dijalankan dengan perintah npm run start. || completed
# Kriteria 3 : API dapat menyimpan buku || completed
### API yang Anda buat harus dapat menyimpan buku melalui route:
Method : POST
URL : /books
Body Request:
{
"name": string,
"year": number,
"author": string,
"summary": string,
"publisher": string,
"pageCount": number,
"readPage": number,
"reading": boolean
}
### Objek buku yang disimpan pada server harus memiliki struktur seperti contoh di bawah ini:
{
"id": "Qbax5Oy7L8WKf74l",
"name": "Buku A",
"year": 2010,
"author": "John Doe",
"summary": "Lorem ipsum dolor sit amet",
"publisher": "Dicoding Indonesia",
"pageCount": 100,
"readPage": 25,
"finished": false,
"reading": false,
"insertedAt": "2021-03-04T09:11:44.598Z",
"updatedAt": "2021-03-04T09:11:44.598Z"
}
### Client tidak melampirkan properti namepada request body. Bila hal ini terjadi, maka server akan merespons dengan:
Status Code : 400
Response Body:
{
"status": "fail",
"message": "Gagal menambahkan buku. Mohon isi nama buku"
}
### Client melampirkan nilai properti readPage yang lebih besar dari nilai properti pageCount. Bila hal ini terjadi, maka server akan merespons dengan:
Status Code : 400
Response Body:
{
"status": "fail",
"message": "Gagal menambahkan buku. readPage tidak boleh lebih besar dari pageCount"
}
### Bila buku berhasil dimasukkan, server harus mengembalikan respons dengan:
Status Code : 201
Response Body:
{
"status": "success",
"message": "Buku berhasil ditambahkan",
"data": {
"bookId": "1L7ZtDUFeGs7VlEt"
}
}
# Kriteria 4 : API dapat menampilkan seluruh buku
API yang Anda buat harus dapat menampilkan seluruh buku yang disimpan melalui route:
Method : GET
URL: /books
Server harus mengembalikan respons dengan:
Status Code : 200
Response Body:
{
"status": "success",
"data": {
"books": [
{
"id": "Qbax5Oy7L8WKf74l",
"name": "Buku A",
"publisher": "Dicoding Indonesia"
},
{
"id": "1L7ZtDUFeGs7VlEt",
"name": "Buku B",
"publisher": "Dicoding Indonesia"
},
{
"id": "K8DZbfI-t3LrY7lD",
"name": "Buku C",
"publisher": "Dicoding Indonesia"
}
]
}
}
# Jika belum terdapat buku yang dimasukkan, server bisa merespons dengan array books kosong.
{
"status": "success",
"data": {
"books": []
}
}
# Kriteria 5 : API dapat menampilkan detail buku
API yang Anda buat harus dapat menampilkan seluruh buku yang disimpan melalui route:
Method : GET
URL: /books/{bookId}
Bila buku dengan id yang dilampirkan oleh client tidak ditemukan, maka server harus mengembalikan respons dengan:
Status Code : 404
Response Body:
{
"status": "fail",
"message": "Buku tidak ditemukan"
}
Bila buku dengan id yang dilampirkan ditemukan, maka server harus mengembalikan respons dengan:
Status Code : 200
Response Body:
{
"status": "success",
"data": {
"book": {
"id": "aWZBUW3JN_VBE-9I",
"name": "Buku A Revisi",
"year": 2011,
"author": "Jane Doe",
"summary": "Lorem Dolor sit Amet",
"publisher": "Dicoding",
"pageCount": 200,
"readPage": 26,
"finished": false,
"reading": false,
"insertedAt": "2021-03-05T06:14:28.930Z",
"updatedAt": "2021-03-05T06:14:30.718Z"
}
}
}
# Kriteria 6 : API dapat mengubah data buku
API yang Anda buat harus dapat mengubah data buku berdasarkan id melalui route:
Method : PUT
URL : /books/{bookId}
Body Request:
{
"name": string,
"year": number,
"author": string,
"summary": string,
"publisher": string,
"pageCount": number,
"readPage": number,
"reading": boolean
}
Server harus merespons gagal bila:
### Client tidak melampirkan properti name pada request body. Bila hal ini terjadi, maka server akan merespons dengan:
Status Code : 400
Response Body:
{
"status": "fail",
"message": "Gagal memperbarui buku. Mohon isi nama buku"
}
### Client melampirkan nilai properti readPage yang lebih besar dari nilai properti pageCount. Bila hal ini terjadi, maka server akan merespons dengan:
Status Code : 400
Response Body:
{
"status": "fail",
"message": "Gagal memperbarui buku. readPage tidak boleh lebih besar dari pageCount"
}
### Id yang dilampirkan oleh client tidak ditemukkan oleh server. Bila hal ini terjadi, maka server akan merespons dengan:
Status Code : 404
Response Body:
{
"status": "fail",
"message": "Gagal memperbarui buku. Id tidak ditemukan"
}
### Bila buku berhasil diperbarui, server harus mengembalikan respons dengan:
Status Code : 200
Response Body:
{
"status": "success",
"message": "Buku berhasil diperbarui"
}
# Kriteria 7 : API dapat menghapus buku
### API yang Anda buat harus dapat menghapus buku berdasarkan id melalui route berikut:
Method : DELETE
URL: /books/{bookId}
### Bila id yang dilampirkan tidak dimiliki oleh buku manapun, maka server harus mengembalikan respons berikut:
Status Code : 404
Response Body:
{
"status": "fail",
"message": "Buku gagal dihapus. Id tidak ditemukan"
}
### id dimiliki oleh salah satu buku, maka buku tersebut harus dihapus dan server mengembalikan respons berikut:
Status Code : 200
Response Body:
{
"status": "success",
"message": "Buku berhasil dihapus"
}