Beranda/API publik

API Publik UMKM

Data UMKM Kabupaten Keerom dalam format JSON. Hanya baca (read-only), tanpa kunci akses, dan dapat dipakai website kampung lain.

Read-only JSON CORS terbuka

Endpoint

Daftar UMKM

Buka

Method	Path	Keterangan
GET	`/api.php/public/umkm`	Daftar UMKM (paginasi + filter)
GET	`/api.php/public/umkm/{id}`	Detail satu UMKM
GET	`/api.php/public/kampung`	Daftar kampung + jumlah UMKM
GET	`/api.php/public/kategori`	Daftar kategori + jumlah UMKM
GET	`/api.php`	Informasi & daftar endpoint

Bentuk /api.php/api/public/umkm juga diterima, sehingga kompatibel dengan pola /api/public/umkm.

Parameter

Nama	Tipe	Default	Keterangan
`page`	integer	1	Nomor halaman.
`perPage`	integer	20	Jumlah data per halaman (maksimal 100).
`kategori`	string	—	Slug atau nama kategori: kuliner, pertanian, perkebunan, perikanan, kerajinan, jasa, perdagangan.
`q`	string	—	Pencarian pada nama usaha, pengelola, produk, dan deskripsi.
`status`	string	aktif	Status usaha: aktif, nonaktif, tutup, atau semua.
`distrik`	string	—	Slug distrik, contoh: arso, skanto, yaffi.
`kampung`	string	—	Nama kampung, contoh: Jaifuri.
`pretty`	boolean	—	Isi 1 untuk keluaran JSON yang dirapikan.

Contoh respons

{
    "status": "success",
    "source": "KEEROM DIGITAL — Direktori UMKM Kabupaten Keerom",
    "endpoint": "/api/public/umkm",
    "method": "GET",
    "read_only": true,
    "pagination": {
        "page": 1,
        "perPage": 1,
        "totalItems": 188,
        "totalPages": 188,
        "hasNext": true,
        "hasPrev": false
    },
    "filters": {
        "status_usaha": "aktif",
        "is_public": true
    },
    "total": 1,
    "data": [
        {
            "id": "um-3f08efcd",
            "nama_usaha": "ABIDIN MOTOR",
            "kategori": "Jasa & Perbengkelan",
            "subkategori": null,
            "kampung": "Kampung Yatu Raharja",
            "distrik": "Distrik Arso Barat",
            "kabupaten": "Kabupaten Keerom",
            "distrik_id": "91.11.08",
            "kampung_id": "yatu-raharja",
            "foto_usaha": null,
            "alamat_usaha": null,
            "rt": null,
            "koordinat": {
                "lat": 0,
                "lng": 0
            },
            "status_usaha": "aktif",
            "tahun_berdiri": null,
            "tenaga_kerja": null,
            "tanggal_update": "2026-11-08 11:18:19.000Z"
        }
    ]
}

Penanganan kesalahan

Kode	Arti
400	`invalid_kategori` — nilai kategori tidak dikenali.
404	`not_found` / `endpoint_not_found` — data atau endpoint tidak ada.
405	`method_not_allowed` — API hanya melayani GET.
503	`api_disabled` — API sedang dinonaktifkan pengelola.

Cakupan data

API ini menyajikan seluruh kampung di Kabupaten Keerom.

Nama kampung mengikuti data wilayah portal dan dapat diubah pengelola tanpa mengubah kode.

Catatan

Hanya UMKM berstatus aktif yang dipublikasikan.
Field yang belum diisi bernilai null.
Koordinat lat/lng bernilai 0 bila belum diisi.
Tidak ada data pribadi pelapor aspirasi pada API ini.
Respons dapat di-cache 60 detik.

Contoh pemakaian

fetch('https://portalkeerom.canalkeerom.id/api.php/public/umkm?perPage=10')
.then(r => r.json())
.then(res => console.log(res.data));