Dokumentasi API Wilayah DesaQu
API ini menyediakan data wilayah (provinsi, kabupaten, kecamatan, desa) secara read-only, untuk integrasi aplikasi lain atau kebutuhan otomasi.
Base URL: https://desa.otanaha-qu.com/apiconnectionget.php
Autentikasi
Setiap request WAJIB menggunakan APIKey yang bisa didaftarkan melalui developer.
- Query String:
?apikey=APIKEY_ANDA - atau Header HTTP:
X-APIKEY: APIKEY_ANDA
Contoh:
GET /apiconnectionget.php?table=dataprov&apikey=APIKEY_ANDA
Endpoint: Daftar Provinsi
Ambil semua provinsi
GET /apiconnectionget.php?table=dataprov&apikey=APIKEY_ANDA
Response:
{
"status": true,
"data": [
{"kodep":"11", "namap":"ACEH"},
...
]
}
Endpoint: Daftar Kabupaten
Ambil kabupaten per provinsi
GET /apiconnectionget.php?table=datakab&kodep=KODE_PROVINSI&apikey=APIKEY_ANDA
| Parameter | Keterangan |
|---|---|
| kodep | Kode provinsi (dari response dataprov) |
Response:
{
"status": true,
"data": [
{"kodekab":"1101", "kodep":"11", "namakab":"KABUPATEN SIMEULUE"},
...
]
}
Endpoint: Daftar Kecamatan
Ambil kecamatan per kabupaten
GET /apiconnectionget.php?table=datakec&kodekab=KODE_KABUPATEN&apikey=APIKEY_ANDA
| Parameter | Keterangan |
|---|---|
| kodekab | Kode kabupaten (dari response datakab) |
Response:
{
"status": true,
"data": [
{"kodekec":"1101010", "kodekab":"1101", "namakec":"TEUPAH SELATAN"},
...
]
}
Endpoint: Daftar Desa
Ambil desa per kecamatan
GET /apiconnectionget.php?table=datades&kodekec=KODE_KECAMATAN&apikey=APIKEY_ANDA
| Parameter | Keterangan |
|---|---|
| kodekec | Kode kecamatan (dari response datakec) |
Response:
{
"status": true,
"data": [
{"kodedes":"1101010001", "kodekec":"1101010", "namades":"DESA BANGKA MAKMUR"},
...
]
}
Contoh Kode (cURL & JavaScript)
Contoh cURL
curl "https://desa.otanaha-qu.com/apiconnectionget.php?table=dataprov&apikey=APIKEY_ANDA"
Contoh JavaScript (fetch)
fetch('https://desa.otanaha-qu.com/apiconnectionget.php?table=datakec&kodekab=1101&apikey=APIKEY_ANDA')\n .then(res=>res.json())\n .then(json=>console.log(json));
Error & Troubleshooting
| Kode | Pesan | Penjelasan |
|---|---|---|
| 403 | APIKey tidak valid! | APIKey salah/expired/tidak ditemukan |
| 403 | APIKey wajib diisi! | Tidak ada parameter apikey |
| 200 | Parameter table tidak valid! | Parameter table salah/tidak diisi |
| 200 | Koneksi DB gagal! | Koneksi database bermasalah |
Kontak
Untuk permintaan APIKey baru atau bantuan teknis, hubungi admin via email atau kontak yang tersedia pada website resmi.