API Documentation - Detail Buku

Berikut adalah cara untuk mengakses detail buku tertentu menggunakan API:

Endpoint

GET /book/{id} (Gantilah {id} dengan ID buku yang ingin Anda lihat)

Autentikasi

Untuk mengakses API ini, Anda perlu mengirimkan kode autentikasi melalui header MISCHOOL-CODE yang diterima setelah meminta akses dari admin.

Contoh Permintaan API

Gunakan perintah curl berikut untuk mendapatkan detail buku dengan ID tertentu:

    curl --location 'https://pleiades.mizanforschool.com/book/{{ BOOK_ID }}' \
    --header 'MISCHOOL-CODE: {{ MISCHOOL_CODE }}'

Respons API

Jika permintaan berhasil, Anda akan mendapatkan respons berupa detail buku dalam format JSON seperti berikut:

    {
        "status": true,
        "message": "The book data has been succes displayed",
        "data": {
            "id": 408,
            "description": "BELTY!!! Siapakah Belty? Apakah Belty itu? Sekejam apakah Belty sehingga mau memakan Ella?",
            "title": "KKPK Butterfly Stories",
            "publishers": [
                "DAR! Mizan"
            ],
            "author": {
                "name": "Malva Aldinia Azahra",
                "image": "https://mischool.sgp1.cdn.digitaloceanspaces.com/ar9JBJqYem5flGWVczxtOEFmDQpdmQlJlnB0BtTM.png"
            },
            "chapters": [],
            "image": "https://mischool.sgp1.cdn.digitaloceanspaces.com/KWx6r9W4DeuYvz58T40YMgjBvfxfHExsiiEQw2NE.jpg",
            "highlights": [
                {
                    "id": 320,
                    "text": "Tidak salah lagi, itulah suara Ratu Vaya,",
                    "title": "full-version",
                    "chapter_id": null,
                    "chapter_title": null,
                    "date": "2 bulan yang lalu"
                }
            ],
            "version": "full",
            "type": "epub",
            "status": "publish",
            "book_status": "Sedang Berlangsung",
            "language": "Indonesia",
            "vote": 0,
            "updated": "3 bulan yang lalu",
            "content": "..."
            "total_page": 19
        }
    }

Respons Error

Jika terjadi kesalahan, misalnya MISCHOOL-CODE yang tidak valid atau ID buku yang tidak ditemukan, API akan mengembalikan respons error seperti berikut:

    {
      "status": "error",
      "message": "Unauthorized: Invalid MISCHOOL-CODE."
    }

    {
      "status": "error",
      "message": "Not Found: Buku dengan ID 376 tidak ditemukan."
    }

Header yang Diperlukan

Permintaan API harus menyertakan header MISCHOOL-CODE sebagai berikut:

    MISCHOOL-CODE: YOUR_SECRET_KEY