Pencarian buku, ISBN, dan subjek berbasis Open Library.
Pencarian buku dan detail ISBN gratis; daftar buku per subjek adalah Premium. Sampul buku disajikan sebagai URL milik Open Library (tidak di-host ulang).
/api/v1/books/searchFreecache 1 jamPencarian judul, penulis, atau kata kunci di Open Library, dengan pagination.
| Parameter | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| q | query | string | Ya | Kata kunci. |
| page | query | integer | Tidak | Nomor halaman. Default: 1. Rentang: 1 - 100. |
| limit | query | integer | Tidak | Item per halaman. Default: 10. Rentang: 1 - 50. |
curl "https://layananapirannz.web.id/api/v1/books/search?q=laskar%20pelangi" \
-H "Authorization: Bearer YOUR_API_KEY"{
"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.
{
"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./api/v1/books/isbn/:isbnFreecache 24 jamISBN-10 atau ISBN-13 (tanpa tanda hubung).
| Parameter | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| isbn | path | string | Ya | ISBN-10 atau ISBN-13. |
curl "https://layananapirannz.web.id/api/v1/books/isbn/9780140328721" \
-H "Authorization: Bearer YOUR_API_KEY"{
"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.
{
"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./api/v1/books/subject/:subjectPremiumcache 1 jamKarya populer pada sebuah subjek (contoh: science_fiction). Endpoint Premium.
| Parameter | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| subject | path | string | Ya | Slug subjek Open Library (huruf kecil, garis bawah). |
| limit | query | integer | Tidak | Item per halaman. Default: 12. Rentang: 1 - 50. |
| offset | query | integer | Tidak | Offset awal. Default: 0. Rentang: 0 - 5000. |
curl "https://layananapirannz.web.id/api/v1/books/subject/science_fiction" \
-H "Authorization: Bearer YOUR_API_KEY"{
"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.
{
"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.