API Documentation - Daftar Buku

Berikut adalah cara untuk mengakses daftar buku menggunakan API:

Endpoint

GET /book

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 daftar buku dengan filter:

    curl --location 'https://pleiades.mizanforschool.com/book?limit={{ JUMLAH_LIMIT_DATA }}&page={{ PAGE_UNTUK_PAGINATION }}&category_id={{ CATEGORY_ID_UNTUK_FILTER_BY_CATEGORY }}' \
    --header 'MISCHOOL-CODE: {{ MISCHOOL_CODE }}'
                

Respons API

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

    {
      "status": "success",
      "data": [
        {
            "book_id": 587,
            "title": "test pagination",
            "image": "https://sobat.sgp1.cdn.digitaloceanspaces.com/mischool/HB4lY7evLozwzzd0bSda6mPfeD6d04sAQrra0Pv4.png",
            "author": {
                "name": "Aku",
                "image": "https://mischool.sgp1.cdn.digitaloceanspaces.com/ar9JBJqYem5flGWVczxtOEFmDQpdmQlJlnB0BtTM.png"
            },
            "description": "test pagination\r\n",
            "view": 0,
            "comment": 0,
            "star": 0,
            "type": "epub"
        },
      ]
    }
                

Respons Error

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

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

Header yang Diperlukan

Permintaan API harus menyertakan header MISCHOOL-CODE sebagai berikut:

    MISCHOOL-CODE: YOUR_SECRET_KEY