https://github.com/abdipr/jagokata-api
Unofficial JagoKata REST API
https://github.com/abdipr/jagokata-api
api jagokata php rest-api scraping simplehtmldom
Last synced: 7 months ago
JSON representation
Unofficial JagoKata REST API
- Host: GitHub
- URL: https://github.com/abdipr/jagokata-api
- Owner: abdipr
- License: mit
- Created: 2024-11-10T04:37:11.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-09T01:13:44.000Z (11 months ago)
- Last Synced: 2025-06-20T18:12:49.132Z (9 months ago)
- Topics: api, jagokata, php, rest-api, scraping, simplehtmldom
- Language: PHP
- Homepage: https://jagokata-api.rf.gd
- Size: 62.5 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
JagoKata REST API
API RESTful untuk mengambil data kutipan, peribahasa, dan informasi tokoh dari situs JagoKata. API ini menyediakan berbagai endpoint untuk mengakses kutipan populer, kutipan acak, pencarian kutipan, dan banyak lagi.
## ✨ Dukungan
Jika kamu menyukai project ini, silakan berikan bintang di repository ini, terima kasih ⭐
Kamu juga bisa mendukung saya dengan cara:
## Daftar Isi
- [Memulai](#-memulai)
- [Pengenalan](#pengenalan)
- [Persyaratan](#persyaratan)
- [Instalasi](#instalasi)
- [Referensi](#%EF%B8%8F-referensi)
- [Endpoints](#endpoints)
- [Parameter Request](#parameter-request)
- [Parameter Response](#parameter-response)
- [Penanganan Error](#-penanganan-error)
- [Contoh](#-contoh)
- [Contoh 1: Quotes Populer](#contoh-1-mendapatkan-quotes-populer)
- [Contoh 2: Cari Quotes](#contoh-2-mencari-quotes)
- [Contoh 3: Quotes Berdasarkan Tokoh](#contoh-3-mencari-quotes-berdasarkan-tokoh)
- [Kontribusi](#-kontribusi)
- [Lisensi](#%EF%B8%8F-lisensi)
- [Disclaimer](#%EF%B8%8F-disclaimer)
## 🚀 Memulai
### Pengenalan
JagoKata REST API adalah API yang memberikan akses terstruktur ke data kutipan, peribahasa, dan informasi tokoh dari situs JagoKata. API ini cocok untuk aplikasi yang memerlukan data kutipan dan peribahasa secara dinamis tanpa harus langsung mengakses situs JagoKata.
### Persyaratan
- PHP 7.4 atau lebih baru
- [simple_html_dom.php](https://simplehtmldom.sourceforge.io/) untuk parsing HTML
- Akses internet untuk scraping situs JagoKata
### Instalasi
1. Clone repository ini ke server:
```bash
git clone https://github.com/abdipr/jagokata-api.git
cd jagokata-api
```
2. Download dan sertakan `simple_html_dom.php` di direktori project.
3. Atur server kamu untuk menyajikan file PHP (misal: Apache atau Nginx).
4. Atau, kamu bisa langsung deploy ke Vercel
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fabdipr%2Fjagokata-api%2F&redirect-url=https%3A%2F%2Fgithub.com%2Fabdipr%2Fjagokata-api%2F)
⚠️ Jangan lupa untuk ubah runtime menjadi `Node.js 18.x`
### ⚠️ Migrasi API
Request di JagoKata API yang di-host di Vercel telah mencapai limit akun free, jadi silakan ubah base URL ke https://jagokata-api.rf.gd.
Terima kasih atas perhatiannya
## ❇️ Referensi
### Endpoints
Base URL: https://jagokata-api.rf.gd
| Endpoint | Deskripsi | Parameter |
| :------------------------ | :-------------------------------------------- | :-------: |
| `GET /popular.php` | Mendapatkan quotes populer | `page` |
| `GET /acak.php` | Mendapatkan quotes secara acak | `page` |
| `GET /search.php` | Mencari quotes |`q`, `page`|
| `GET /tokoh.php` | Mencari quotes dari huruf inisial | `huruf` |
| `GET /author.php` | Mendapatkan semua quotes dari seorang author |`name`, `page`|
| `GET /peribahasa.php` | Mendapatkan peribahasa dari kata | `kata` |
| `GET /peribahasa-acak.php`| Mendapatkan 10 peribahasa secara acak | |
### Parameter Request
| Parameter | Deskripsi |
| :-------: | :----------------------------------- |
| `q` | Query pencarian |
| `huruf` | Inisial nama tokoh |
| `name` | Nama tokoh lengkap |
| `kata` | Kata kunci untuk peribahasa |
| `page` | Indikator halaman (opsional) |
### Parameter Response
| Parameter | Deskripsi |
| :------------ | :----------------------------------- |
| `id` | ID unik dari quotes |
| `author` | Nama tokoh yang mengucapkan quotes |
| `text` | Teks dari quotes atau peribahasa |
| `category` | Kategori dari tokoh |
| `source` | Sumber kutipan (jika tersedia) |
## 💥 Penanganan Error
Semua error mengembalikan objek JSON dengan kode `status` dan `message` yang menjelaskan masalah.
- **404 Error**:
- Ketika halaman tidak ditemukan atau parameter query hilang.
```json
{
"status": "404",
"author": "abdiputranar",
"message": "Page not found"
}
```
## 🌐 Contoh
### Contoh 1: Mendapatkan Quotes Populer
Ambil quotes populer tanpa parameter:
```http
GET https://jagokata-api.rf.gd/popular.php
```
### Contoh 2: Mencari Quotes
Cari kutipan dengan kata kunci tertentu:
```http
GET https://jagokata-api.rf.gd/search.php?q=kehidupan
```
### Contoh 3: Mencari Quotes Berdasarkan Tokoh
Ambil semua quotes dari tokoh dengan nama inisial tertentu:
```http
GET https://jagokata-api.rf.gd/tokoh.php?huruf=A
```
### Catatan
- **Parameter `q`**: Digunakan untuk pencarian quotes.
- **Parameter `huruf`**: Digunakan untuk menemukan tokoh berdasarkan inisial.
- **Parameter `name`**: Nama lengkap tokoh untuk mengambil semua quotes mereka.
- **Parameter `kata`**: Kata kunci untuk mencari peribahasa.
## 🌱 Kontribusi
Kontribusi diperbolehkan! Untuk berkontribusi:
1. Fork repository ini.
2. Buat branch fitur baru: `git checkout -b fitur-baru`.
3. Commit perubahanmu: `git commit -m 'Menambahkan fitur'`.
4. Push ke branch: `git push origin fitur-baru`.
5. Buat pull request.
## ⚖️ Lisensi
Project ini dilisensikan di bawah `MIT License`. Lihat file [LICENSE](https://github.com/abdipr/jagokata-api/blob/main/LICENSE) untuk informasi lebih lanjut.
## ⚠️ Disclaimer
Data yang disediakan oleh API ini diperoleh dari situs [JagoKata](https://jagokata.com) melalui proses web scraping. Developer yang menggunakan API ini harus mengikuti peraturan yang berlaku dengan mencantumkan project ini atau pemilik resmi dalam project mereka dan dilarang menyalahgunakan API ini untuk keuntungan pribadi.
[⬆️ Kembali ke Atas](#jagokata-rest-api)