Rannz Book API

Cari buku

Pencarian judul, penulis, atau kata kunci di Open Library, dengan pagination.

Contoh request

curl "https://layananapirannz.web.id/api/v1/books/search?q=laskar%20pelangi" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "total": 42,
    "page": 1,
    "items": [
      {
        "workKey": "/works/OL45883W",
        "title": "Laskar Pelangi",
        "authors": [
          "Andrea Hirata"
        ],
        "firstPublishYear": 2005,
        "editionCount": 20,
        "pagesMedian": 529,
        "languages": [
          "ind"
        ],
        "subjects": [
          "Fiction"
        ],
        "isbnSample": "9789793062792",
        "coverUrl": "https://covers.openlibrary.org/b/id/0000000-M.jpg",
        "url": "https://openlibrary.org/works/OL45883W"
      }
    ]
  },
  "meta": {
    "requestId": "…",
    "endpoint": "books.search",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "q",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

• 400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
• 401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
• 403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
• 403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
• 404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
• 429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
• 429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
• 502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
• 502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

Detail edisi buku berdasarkan ISBN

ISBN-10 atau ISBN-13 (tanpa tanda hubung).

Contoh request

curl "https://layananapirannz.web.id/api/v1/books/isbn/9780140328721" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "isbn": "9780140328721",
    "title": "Fantastic Mr. Fox",
    "authors": [
      "Roald Dahl"
    ],
    "publishers": [
      "Puffin"
    ],
    "publishDate": "1988",
    "pages": 96,
    "subjects": [
      "Foxes"
    ],
    "cover": "https://covers.openlibrary.org/b/id/0000000-L.jpg",
    "url": "https://openlibrary.org/books/OL0000000M"
  },
  "meta": {
    "requestId": "…",
    "endpoint": "books.isbn",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "isbn",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

• 400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
• 401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
• 403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
• 403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
• 404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
• 429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
• 429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
• 502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
• 502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

Daftar buku berdasarkan subjek

Karya populer pada sebuah subjek (contoh: science_fiction). Endpoint Premium.

Contoh request

curl "https://layananapirannz.web.id/api/v1/books/subject/science_fiction" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "subject": "science fiction",
    "totalWorks": 5000,
    "items": [
      {
        "workKey": "/works/OL1W",
        "title": "Contoh",
        "authors": [
          "Penulis"
        ],
        "firstPublishYear": 1999,
        "coverUrl": null,
        "url": "https://openlibrary.org/works/OL1W"
      }
    ]
  },
  "meta": {
    "requestId": "…",
    "endpoint": "books.subject",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "subject",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

• 400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
• 401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
• 403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
• 403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
• 404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
• 429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
• 429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
• 502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
• 502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.