Search All
Mencari semua data yang tersedia, meliputi perguruan tinggi, program studi, dosen, dan mahasiswa.
Dokumentasi ini menjelaskan cara menggunakan endpoint Search All
dan bagaimana struktur response yang akan Kamu terima. Dengan endpoint ini, Kamu dapat melakukan pencarian terpadu untuk berbagai jenis data yang ada di sistem.
Endpoint
Untuk melakukan pencarian, Kamu dapat menggunakan endpoint berikut:
GET /search/all/<str:keyword>
Pada endpoint ini, keyword
bisa diisi dengan nama perguruan tinggi, program studi, dosen, mahasiswa, atau kombinasi dari nim, nidn, dan lainnya.
Contoh Endpoint
Untuk memberikan gambaran yang lebih jelas, berikut adalah contoh penggunaan endpoint:
GET /search/all/ridwan halim uty
Dalam contoh ini, API akan mencoba mencari data yang sesuai dengan keyword
ridwan halim uty
di antara semua entitas yang tersedia (mahasiswa, dosen, perguruan tinggi, program studi).
Contoh Penggunaan
perhatian!:
Ada 3 contoh yang dapat kamu praktikkan sesuai kebutuhan. Python, PHP, dan Direct API Access (langsung ke browser).
Berikut adalah 3 contoh penggunaan yang kami buat, yaitu menggunakan Python, PHP, dan akses API secara langsung.
Kamu dapat mengubah keyword
sesuai kebutuhan kamu.
import requests
import json
def fetch_api(api_url):
try:
response = requests.get(api_url)
response.raise_for_status()
return response.json()
except requests.exceptions.RequestException as e:
print(f"Error: {e}")
return None
url = "https://api-pddikti.ridwaanhall.com/search/all"
keyword = "ridwan halim uty"
api_url = f"{url}/{keyword}"
data = fetch_api(api_url)
print(json.dumps(data, indent=4) if data else "No data fetched.")
- Mengirim Permintaan: Fungsi
fetch_api
mengirim permintaan GET ke URL API dan mengembalikan data JSON. - Menggabungkan URL:
url
dankeyword
digabungkan untuk membentuk URL lengkap. - Mencetak Hasil: Data yang diambil dicetak dalam format JSON yang rapi atau pesan kesalahan jika data tidak ditemukan.
Response
Response ini terdapat 2 bagian, yaitu hasil response
dan struktur json
.
{
"mahasiswa": [
{
"id": "MSR1Om0isJDmM8gtZ22XVh4pfQc_pgft3tWrtqTfAYzBYKSaoZEFxBYviGHNQAIr6ekiuQ==",
"nama": "RIDWAN HALIM",
"nim": "5210411257",
"nama_pt": "UNIVERSITAS TEKNOLOGI YOGYAKARTA",
"sinkatan_pt": "UTY",
"nama_prodi": "INFORMATIKA"
}
],
"dosen": null,
"pt": null,
"prodi": null
}
- Mahasiswa: Berisi informasi tentang mahasiswa, termasuk ID, nama, NIM, nama perguruan tinggi, singkatan perguruan tinggi, dan nama program studi.
- Dosen: Tidak ada data dosen yang tersedia.
- PT: Tidak ada data perguruan tinggi yang tersedia.
- Prodi: Tidak ada data program studi yang tersedia.