REST API v1

Dokumentasi API WiHub

API publik WiHub memberi akses baca (read-only) ke data tempat, kategori, dan fasilitas yang sudah disetujui. Cocok untuk integrasi ke aplikasi atau situs pihak ketiga.

1. Autentikasi

Setiap permintaan wajib menyertakan API key lewat header X-API-Key atau parameter query ?api_key=.

curl -H "X-API-Key: demo_wifinder_api_key_12345" \
  "https://wihub.site/api/v1/places.php"

Gunakan API key demo di atas untuk mencoba. Hubungi admin melalui halaman Tentang Kami untuk mendapatkan key produksi.

2. Batas Permintaan (Rate Limit)

Setiap API key punya batas permintaan per menit dan per hari (default 60/menit, 2000/hari, dapat disesuaikan admin). Jika terlampaui, API mengembalikan status 429 Too Many Requests.

3. Endpoint

GET /api/v1/places.php

Daftar tempat yang sudah disetujui.

Parameter	Keterangan
q	Pencarian nama/kota (opsional)
category	Slug kategori (opsional)
city	Nama kota (opsional)
page, limit	Pagination (limit maks. 50)

GET /api/v1/place.php?slug=le-cafe

Detail satu tempat berdasarkan slug, termasuk fasilitas & data WiFi.

GET /api/v1/categories.php

Daftar semua kategori tempat.

GET /api/v1/facilities.php

Daftar semua fasilitas yang tersedia sebagai filter.

4. Contoh Respons

{
  "data": [
    {
      "id": 1,
      "name": "Le Cafe",
      "slug": "le-cafe",
      "city": "Kota Cirebon",
      "lat": -6.7242918,
      "lng": 108.5520605,
      "avgRating": 5,
      "ratingCount": 1,
      "isVerified": true,
      "category": { "name": "Coffee Shop", "slug": "coffee-shop" },
      "url": "https://wifinder.test/places/le-cafe"
    }
  ],
  "meta": { "total": 7, "page": 1, "limit": 20 }
}

5. Kode Error

Kode	Arti
401	API key tidak disertakan atau tidak valid
404	Data tidak ditemukan
429	Batas permintaan (rate limit) tercapai