Search Mahasiswa

Mencari data mahasiswa berdasarkan kata kunci.

Dokumentasi ini menjelaskan cara menggunakan endpoint Search Mahasiswa dan bagaimana struktur response yang akan Kamu terima. Dengan endpoint ini, Kamu dapat melakukan pencarian data mahasiswa berdasarkan nama, NIM, atau kombinasi dengan nama perguruan tinggi.

Endpoint

Untuk melakukan pencarian data Mahasiswa, Kamu dapat menggunakan endpoint berikut:

GET /search/mhs/<str:keyword>

Pada endpoint ini, keyword dapat diisi dengan nim, nama mahasiswa, nama program studi, nama perguruan tinggi, atau kombinasi dari keempatnya.

Contoh Endpoint

Untuk memberikan gambaran yang lebih jelas, berikut adalah contoh penggunaan endpoint:

GET /search/mhs/ridwan halim informatika uty

Dalam contoh ini, API akan mencoba mencari data mahasiswa yang sesuai dengan keyword ridwan halim informatika uty (nama mahasiswa, nama program studi, dan singkatan perguruan tinggi).

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.

main.py
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/mhs"
keyword = "ridwan halim informatika 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 dan keyword 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 berisi informasi mahasiswa yang sesuai dengan keyword yang diberikan.

response.json
{
  "mahasiswa": [
    {
        "id": "w62Z95aFYK8sHzG6DtCIUw_Vm2pNmOgbwQR44MwOgAqKZpGq9lx99tG2uMWQmDIQ5GkcgQ==",
        "nama": "RIDWAN HALIM",
        "nim": "5210411257",
        "nama_pt": "UNIVERSITAS TEKNOLOGI YOGYAKARTA",
        "sinkatan_pt": "UTY",
        "nama_prodi": "INFORMATIKA"
    }
  ]
}
  • Mahasiswa: Berisi daftar informasi mahasiswa, termasuk ID, nama, NIM, nama perguruan tinggi, singkatan perguruan tinggi, dan nama program studi.