API-KBBI-PHP-Codeigniter-4

KO | EN

gitlite — search

#python #hacktoberfest #llm #golang #android #machine-learning #rust #docker #windows #cli #vue #pytorch #openai #mcp

API-KBBI-PHP-Codeigniter-4

(★ 19)

Unofficial API Kamus Besar Bahasa Indonesia (KBBI) 2026 dengan PHP 8.5 dan Framework Codeigniter 4.7.4

API-KBBI-PHP-Codeigniter-4 Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
 <img src="kbbi.webp" width="150" alt="Logo KBBI" />
 <h1>Unofficial API Kamus Besar Bahasa Indonesia (KBBI) 2026</h1>
 API pencarian makna kata dan peribahasa KBBI berbasis penapisan HTML menggunakan CodeIgniter 4 dan PHP 8.
 
 
 <img src="https://img.shields.io/badge/PHP-8.1%20%7C%208.2%20%7C%208.3%20%7C%208.4%20%7C%208.5-777bb4?style=flat-square&logo=php" alt="PHP Version" />
 <img src="https://img.shields.io/badge/CodeIgniter-4.7.4-dd4814?style=flat-square&logo=codeigniter" alt="CodeIgniter Version" />
 <img src="https://img.shields.io/badge/License-MIT-blue?style=flat-square" alt="License" />
 
</div>

---

## Tangkapan Layar (Screenshots)

Berikut adalah beberapa tampilan dasbor dari API KBBI 2026:

<details>
<summary>Klik untuk melihat tangkapan layar</summary>

### 1. Dasbor Utama (Informasi Teknologi dan Spesifikasi)

Halaman utama yang menampilkan status server, spesifikasi sistem, data penulis, dan daftar endpoint yang tersedia.

### 2. Tampilan JSON View (Raw JSON)

Tampilan data visualisasi spesifikasi sistem dan konfigurasi API dalam representasi JSON interaktif.

### 3. Uji Coba API (Sandbox Tab)

Fitur sandbox untuk menguji pencarian kata secara langsung dari halaman utama.

### 4. Peringatan Validasi Konfigurasi Server (.env dan GeoNode Key)

Notifikasi yang otomatis muncul jika berkas konfigurasi `.env` atau GeoNode API Key belum dikonfigurasi dengan benar di server.

</details>

---

## Alur Kerja Pengambilan Data (Scraping Workflow)

Untuk menjaga performa dan efisiensi kuota, API ini menggunakan alur kerja multi-lapis saat mencari sebuah kata:

```mermaid
graph TD
    Start([Mulai Pencarian Kata]) --> Lapis1[Lapis 1: Scraping Langsung cURL ke KBBI Resmi]

Lapis1 --> CheckSuccess1{Apakah Scraping Langsung Sukses?}
    CheckSuccess1 -- Ya --> ParseHTML[Ubah Struktur HTML ke JSON] --> ReturnData([Kembalikan Hasil Pencarian])
    CheckSuccess1 -- Tidak/WAF Block/Timeout --> Lapis2[Lapis 2: Fallback ke GeoNode Scraper API]

Lapis2 --> CheckConfig{Apakah GeoNode API Key Terkonfigurasi?}
    CheckConfig -- Tidak --> ShowErrorConfig[Tolak & Kembalikan Error Konfigurasi]
    CheckConfig -- Ya --> CheckLimit{Apakah Total Limit Bulanan Lokal Tercapai?}

CheckLimit -- Ya --> ShowErrorLimit[Tolak & Kembalikan Error Jatah Limit]
    CheckLimit -- Tidak --> ExecGeoNode[Kirim Request via Proxy Residential GeoNode]

ExecGeoNode --> RotateKey[Rotasi API Key secara Round-Robin]
    RotateKey --> SaveLimit[Catat Penggunaan Kuota lokal di geonode_limit.json]
    SaveLimit --> ParseHTML
```

1. **Lapis 1 - Scraping Langsung (Direct Request):** Sistem mencoba melakukan koneksi cURL langsung ke situs resmi KBBI. Proses ini bersifat gratis dan tanpa batasan (sangat cocok untuk localhost).
2. **Lapis 2 - Fallback GeoNode Scraper API (Automated):** Jika koneksi langsung di atas gagal atau mengalami waktu habis (terutama saat dideploy di server VPS yang diblokir oleh WAF KBBI), sistem akan otomatis mengalihkan permintaan menggunakan **GeoNode Scraper API** melalui Proxy Residensial.
3. **Rotasi Multi-Akun dan Jatah Kuota Lokal:** Mendukung penggunaan lebih dari 1 GeoNode API Key secara bergantian (round-robin) dan dilengkapi dengan pencatat batas kuota bulanan lokal otomatis (`writable/geonode_limit.json`) berdasarkan tanggal pembaruan masing-masing akun agar kuota gratis Anda tidak terlampaui.

---

## Panduan Konfigurasi Proyek secara Detail

Ikuti langkah-langkah di bawah ini untuk memasang dan menjalankan API KBBI ini pada mesin lokal Anda:

### Prasyarat Sistem

- PHP versi **8.1** atau yang lebih baru (Disarankan PHP 8.2 / 8.3 / 8.4 / 8.5)
- Ekstensi PHP diaktifkan: `curl`, `dom`, `xml`
- [Composer](https://getcomposer.org/) terinstal pada komputer Anda
- Server Lokal (Disarankan menggunakan **Laragon**, **XAMPP**, atau **WAMP** untuk mempermudah pengaturan lingkungan lokal PHP)

### Langkah-langkah Instalasi

#### 1. Klon Repositori

Unduh kode sumber proyek ini ke komputer lokal Anda:

```bash
git clone https://github.com/dyazincahya/API-KBBI-PHP-Codeigniter-4.git
cd API-KBBI-PHP-Codeigniter-4
```

#### 2. Instal Dependensi (Composer)

Jalankan perintah berikut untuk mengunduh semua pustaka dependensi framework CodeIgniter 4:

```bash
composer install
```

#### 3. Konfigurasi Berkas Lingkungan (.env)

Salin berkas konfigurasi bawaan `env` menjadi `.env`:

```bash
cp env .env
```

_(Di Windows PowerShell, gunakan perintah: `copy env .env`)_

#### 4. Pengaturan GeoNode API Key (Wajib untuk Server/Hosting)

Jika Anda menerapkan API ini ke hosting/VPS, IP server Anda kemungkinan besar akan diblokir oleh WAF resmi KBBI. Anda wajib menyiapkannya dengan cara:

1. Daftar akun gratis di **[GeoNode Scraper API](https://app.geonode.com/scraper-api)**.
2. Selesaikan verifikasi email dan salin **API Key** dari dasbor Anda.
3. Buka berkas `.env` hasil salinan tadi menggunakan penyunting teks, lalu konfigurasikan kunci Anda di bagian bawah:
   ```env
   geonode.apiKeys.0.name = 'Akun Utama Anda'
   geonode.apiKeys.0.apikey = 'MASUKKAN_API_KEY_ANDA_DI_SINI'
   geonode.apiKeys.0.limit = 1499
   geonode.apiKeys.0.reset_day = 10
   ```
   _Anda dapat memasukkan lebih dari satu akun/kunci untuk dirotasi secara bergantian oleh sistem._
   _Catatan: Setiap akun GeoNode Scraper API memiliki batasan (limit) gratis sebesar 1.500 permintaan per bulan, yang akan diperbarui secara otomatis (reset) setiap bulannya berdasarkan tanggal pendaftaran masing-masing akun._

#### 5. Jalankan Server Lokal

Nyalakan server pengembangan CodeIgniter menggunakan Spark:

```bash
php spark serve
```

Setelah aktif, buka peramban Anda dan akses halaman utama di:
[http://localhost:8080/](http://localhost:8080/)

---

## API Endpoints dan Contoh Penggunaan

API ini menyediakan beberapa endpoint fleksibel untuk mencari definisi kata atau frasa:

### 1. Informasi API Utama

Mengembalikan deskripsi metadata dasar sistem.

- **URL:** `/kbbi`
- **Metode:** `GET`
- **Contoh Respons:**
  ```json
  {
    "api": {
      "name": "API KBBI 2026",
      "source": "https://kbbi.kemendikdasmen.go.id",
      "method": "HTML Parsing"
    },
    "technology": {
      "lang": "PHP 8.4.12",
      "framework": "CodeIgniter 4.7.4"
    }
  }
  ```

### 2. Pencarian Kata (Format URI)

Mencari definisi kata spesifik berdasarkan segmentasi URI.

- **URL:** `/kbbi/search/{kata_kunci}` (Contoh: `/kbbi/search/demokrasi`)
- **Metode:** `GET`

### 3. Pencarian Kata (Format Query Parameter)

Mencari definisi kata spesifik menggunakan parameter query string.

- **URL:** `/kbbi?search={kata_kunci}` (Contoh: `/kbbi?search=demokrasi`)
- **Metode:** `GET`

### Contoh Respons Hasil Pencarian (`/kbbi/search/demokrasi`):

```json
{
  "success": true,
  "status": 200,
  "message": "Hasil ditemukan.",
  "data": [
    {
      "word": "demokrasi",
      "lema": "de.mo.kra.si",
      "arti": [
        {
          "deskripsi": "n Pol (bentuk atau sistem) pemerintahan yang seluruh rakyatnya turut serta memerintah dengan perantaraan wakilnya; pemerintahan rakyat"
        },
        {
          "deskripsi": "n Pol gagasan atau pandangan hidup yang mengutamakan persamaan hak dan kewajiban serta perlakuan yang sama bagi semua warga negara"
        }
      ],
      "tesaurusLink": "https://tesaurus.kemendikdasmen.go.id/tematis/lema/demokrasi"
    }
  ]
}
```

---

## Optimasi Server Hosting

Agar performa scraping dan request fallback berjalan lancar di server hosting/cPanel Anda, silakan terapkan penyesuaian parameter PHP berikut:

1. `memory_limit`: Ubah ke nilai yang lebih besar (minimal `256M` atau `512M`).
2. `max_execution_time`: Atur ke nilai yang lebih tinggi (minimal `120` detik) untuk menangani waktu tunggu fallback scraper.
3. **OPcache**: Aktifkan OPcache di menu PHP Selector hosting Anda untuk mempercepat eksekusi framework CI4.
4. **Ekstensi PHP**: Pastikan ekstensi `dom`, `xml`, dan `curl` telah diaktifkan.

---

## Alternatif dan Repositori Terkait

- **[KBBI-Go (Versi Bahasa GO)](https://github.com/dyazincahya/kbbi-go)** - API KBBI dengan performa tinggi yang ditulis menggunakan bahasa Go.
- **[kbbi-api (Versi Bahasa Go oleh raf555)](https://github.com/raf555/kbbi-api)** - API KBBI alternatif siap pakai yang dibangun menggunakan bahasa Go.
- **[KBBI-SQL-Database](https://github.com/dyazincahya/KBBI-SQL-database)** - Jika Anda tidak ingin menggunakan API, Anda dapat mengunduh basis data SQL KBBI lengkap dalam format MySQL, SQLite, PostgreSQL, CSV, JSON, atau XML.
- **[MyKBBI Android App](https://play.google.com/store/apps/details?id=com.kang.cahya.apps.mykbbi)** - Aplikasi Kamus Bahasa Indonesia buatan Kang Cahya di Google Play Store.

---

## Lisensi dan Penulis

- Proyek ini dilisensikan di bawah lisensi **MIT License**.
- Dibuat dan dikembangkan oleh **[Kang Cahya](https://kang-cahya.com)**.

API-KBBI-PHP-Codeigniter-4

API-KBBI-PHP-Codeigniter-4 Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

API-KBBI-PHP-Codeigniter-4

API-KBBI-PHP-Codeigniter-4 Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README