README.md

Kamus Besar Bahasa Indonesia (KBBI) Scraper

Library PHP untuk mengambil data dari KBBI. Library ini dibuat untuk mempermudah penggunaan KBBI dengan cara melakukan scraping data dari website KBBI resmi milik Kementerian Pendidikan, Kebudayaan, Riset, dan Teknologi (Kemdikbud).

Instalasi

composer require dipantry/kbbi

Cara Penggunaan

Request

use Dipantry\KBBI\KBBI;

$response = (new KBBI())->search('demokrasi');

Response

Data response yang dikembalikan pada variabel $response berbentuk json. Jika Anda ingin menggunakannya pada kodingan PHP, Anda dapat menggunakan fungsi json_decode untuk mengubah string json menjadi array.

Success Response

{
  "success": true,
  "code": 200,
  "message": "Search word success",
  "data": [
    {
      "spelling": "de.mo.kra.si \/d\u00e9mokrasi\/",
      "meanings": [
        {
          "description": "(bentuk atau sistem) pemerintahan yang seluruh rakyatnya turut serta memerintah dengan perantaraan wakilnya; pemerintahan rakyat",
          "categories": [
            {
              "code": "n",
              "description": "Nomina: kata benda"
            },
            {
              "code" :"Pol",
              "description": "Politik dan Pemerintahan: -"
            }
          ]
        },
        {
          "description": "gagasan atau pandangan hidup yang mengutamakan persamaan hak dan kewajiban serta perlakuan yang sama bagi semua warga negara",
          "categories": [
            {
              "code": "n",
              "description": "Nomina: kata benda"
            },
            {
              "code": "Pol",
              "description": "Politik dan Pemerintahan: -"
            }
          ]
        }
      ]
    }
  ]
}

Failed Response

{
  "success":false,
  "code": 400,
  "message": "Entri tidak ditemukan.",
  "data": null
}

Penjelasan Response

Key	Deskripsi
success	true jika berhasil, false ketika gagal
code	Kode status
message	Pesan berhasil/error
data	Data yang dikembalikan
---	---
spelling	Cara penyebutan kata
meanings	Definisi kata
---	---
description	Arti kata
categories	Kategori kata
---	--
code	Kode kategori
description	Deskripsi kategori

---

Bypass Limit

Website KBBI menggunakan sistem limit apabila melakukan pencarian kata tanpa melakukan login pada website tersebut. Untuk menghindari hal ini, Anda dapat memasukkan kode session ketika Anda melakukan pencarian kata. Kode session dapat ditemukan di website KBBI setelah Anda melakukan login, lalu lakukan langkah berikut:

Inspect Element -> Storage -> Cookies -> .AspNet.ApplicationCookie

Untuk menggunakannya, masukkan kode session pada fungsi search sebagai parameter.

use Dipantry\KBBI\KBBI;

$response = (new KBBI())->search('demokrasi', $session);

---

Testing

Jalankan testing dengan menjalankan perintah berikut ini

vendor/bin/phpunit