Open Data API v1.0 (RESTful) Perpres No. 39/2019

Dokumentasi REST API Terbuka

Akses seluruh data publik resmi Pemerintah Kabupaten Mamasa secara terprogram (Machine-Readable). API ini bebas digunakan oleh masyarakat, akademisi, peneliti, jurnalis data, dan pengembang aplikasi tanpa memerlukan pendaftaran kunci API (API Key).

Publik & Bebas Akses

Tanpa Autentikasi / Kunci API

Respon Standar JSON UTF-8

CORS Diaktifkan (Cross-Origin)

Base URL Resmi


                    https://www.datamamasa.wawandev.my.id/api/v1

Semua pemanggilan endpoint RESTful API menggunakan awalan /api/v1. Header permintaan yang direkomendasikan adalah Accept: application/json.

Peran & Hak Akses

Halaman Publik ini ditujukan bagi pengembang umum, akademisi, dan publik.

Bagi pengelola instansi/OPD, panduan tata kelola interoperabilitas antar-sistem (SPLP) tersedia di Panel Walidata Daerah →

Daftar Endpoint API v1

📊 Statistik 📁 Katalog Dataset 🔍 Metadata Baku 📋 Data Tabular 🏢 30 OPD 🏷️ 8 Topik 🗺️ 17 Kecamatan 📍 Detail Kecamatan

GET /api/v1/statistics • Alias: /api/v1/stats

Statistik Ringkasan Portal

Mengambil angka statistik agregat terkini dari portal Satu Data Kabupaten Mamasa, termasuk jumlah dataset terbit, jumlah OPD produsen, jumlah kecamatan, topik urusan, dan total unduhan.

Contoh Script Pemanggilan:

# Jalankan di terminal bash
curl -X GET "https://www.datamamasa.wawandev.my.id/api/v1/statistics" \
     -H "Accept: application/json"

async function getMamasaStats() {
  try {
    const res = await fetch('https://www.datamamasa.wawandev.my.id/api/v1/statistics', {
      headers: { 'Accept': 'application/json' }
    });
    const data = await res.json();
    console.log('Total Dataset:', data.data.total_dataset_terbuka);
  } catch (err) {
    console.error('Error fetching stats:', err);
  }
}
getMamasaStats();

import requests

url = "https://www.datamamasa.wawandev.my.id/api/v1/statistics"
response = requests.get(url, headers={"Accept": "application/json"})

if response.status_code == 200:
    stats = response.json().get("data", {})
    print(f"Total Dataset Terbuka: {stats.get('total_dataset_terbuka')}")
    print(f"Total OPD: {stats.get('total_opd_produsen')}, Total Kecamatan: {stats.get('total_kecamatan')}")

use Illuminate\Support\Facades\Http;

$response = Http::acceptJson()->get('https://www.datamamasa.wawandev.my.id/api/v1/statistics');

if ($response->successful()) {
    $stats = $response->json('data');
    echo "Total Dataset: " . $stats['total_dataset_terbuka'];
}

Contoh Respon (200 OK):

{
  "status": "success",
  "data": {
    "total_dataset_terbuka": 247,
    "total_opd_produsen": 30,
    "total_kecamatan": 17,
    "total_topik_sektor": 8,
    "total_unduhan_data": 4390,
    "total_permohonan_data": 5
  }
}

GET /api/v1/datasets

Katalog Dataset Terbuka

Mengambil daftar seluruh dataset yang telah disetujui (berstatus approved) dengan dukungan paginasi, pencarian teks bebas, penyaringan berdasarkan topik, OPD, atau kecamatan, serta pengurutan data.

Parameter Query:

Parameter	Tipe	Wajib?	Keterangan
q	string	Opsional	Pencarian kata kunci pada judul, deskripsi, atau tags (contoh: `stunting`, `kopi`)
topic	string	Opsional	Filter berdasarkan slug topik (contoh: `kesehatan`, `pertanian-perkebunan`)
opd	string	Opsional	Filter berdasarkan slug OPD (contoh: `dinkes`, `bpkd`, `distanbun`)
district	string	Opsional	Filter dataset kewilayahan kecamatan (kode kemendagri `76.03.01` atau slug `mamasa`)
sort	string	Opsional	Pengurutan: `latest` (terbaru), `popular` (dilihat terbanyak), `downloads` (diunduh terbanyak)
per_page	integer	Opsional	Batas jumlah data per halaman (default: 15, maksimum: 50)
page	integer	Opsional	Nomor halaman paginasi (default: 1)

Contoh Script Pemanggilan:

# 1. Ambil 10 dataset topik kesehatan terpopuler
curl -X GET "https://www.datamamasa.wawandev.my.id/api/v1/datasets?topic=kesehatan&sort=popular&per_page=10" \
     -H "Accept: application/json"

# 2. Cari dataset kata kunci "stunting"
curl -X GET "https://www.datamamasa.wawandev.my.id/api/v1/datasets?q=stunting" \
     -H "Accept: application/json"

const params = new URLSearchParams({
  q: 'kopi',
  sort: 'latest',
  per_page: 5
});

fetch(`https://www.datamamasa.wawandev.my.id/api/v1/datasets?${params}`)
  .then(res => res.json())
  .then(data => {
    console.log('Ditemukan:', data.pagination.total, 'dataset');
    data.data.forEach(ds => console.log(`- ${ds.title} (${ds.slug})`));
  })
  .catch(err => console.error(err));

import requests

params = {
    "topic": "kesehatan",
    "sort": "popular",
    "per_page": 10
}
res = requests.get("https://www.datamamasa.wawandev.my.id/api/v1/datasets", params=params)
datasets = res.json()["data"]

for item in datasets:
    print(f"{item['title']} | Unduhan: {item['downloads_count']}")

use Illuminate\Support\Facades\Http;

$response = Http::get('https://www.datamamasa.wawandev.my.id/api/v1/datasets', [
    'topic' => 'pertanian-perkebunan',
    'per_page' => 10,
]);

$items = $response->json('data');
foreach ($items as $ds) {
    echo $ds['title'] . PHP_EOL;
}

Contoh Respon (200 OK):

{
  "status": "success",
  "message": "Daftar Dataset Terbuka Kabupaten Mamasa",
  "data": [
    {
      "id": 1,
      "title": "Prevalensi Stunting Balita Menurut Kecamatan di Kabupaten Mamasa Tahun 2023",
      "slug": "prevalensi-stunting-balita-kabupaten-mamasa-2023",
      "views_count": 1240,
      "downloads_count": 380,
      "published_at": "2024-01-15T08:00:00.000000Z"
    }
  ],
  "pagination": {
    "total": 247,
    "per_page": 15,
    "current_page": 1,
    "last_page": 17
  }
}

GET /api/v1/datasets/{slug}

Metadata Baku & Kamus Data

Mengambil rincian komprehensif metadata baku Satu Data Mamasa (SDI), variabel kamus data (*data dictionary*), dan berkas sumber unduhan berdasarkan string unik slug.

Contoh Script Pemanggilan:

curl -X GET "https://www.datamamasa.wawandev.my.id/api/v1/datasets/prevalensi-stunting-balita-kabupaten-mamasa-2023" \
     -H "Accept: application/json"

const slug = 'prevalensi-stunting-balita-kabupaten-mamasa-2023';
const res = await fetch(`https://www.datamamasa.wawandev.my.id/api/v1/datasets/${slug}`);
const { data } = await res.json();

console.log('Produsen:', data.metadata_sdi.opd_produsen.nama);
console.log('Kamus Data:', data.kamus_data);

import requests

slug = "prevalensi-stunting-balita-kabupaten-mamasa-2023"
res = requests.get(f"https://www.datamamasa.wawandev.my.id/api/v1/datasets/{slug}")
data = res.json()["data"]

print("Judul:", data["title"])
print("Standar Data:", data["metadata_sdi"]["standar_data"])
for var in data["kamus_data"]:
    print(f" - {var['variabel']} ({var['tipe_data']}): {var['definisi']}")

use Illuminate\Support\Facades\Http;

$slug = 'prevalensi-stunting-balita-kabupaten-mamasa-2023';
$dataset = Http::get("https://www.datamamasa.wawandev.my.id/api/v1/datasets/{$slug}")->json('data');
echo $dataset['metadata_sdi']['opd_produsen']['nama'];

Contoh Respon (200 OK):

{
  "status": "success",
  "data": {
    "id": 1,
    "title": "Prevalensi Stunting Balita Menurut Kecamatan di Kabupaten Mamasa Tahun 2023",
    "metadata_sdi": {
      "opd_produsen": {
        "nama": "Dinas Kesehatan Daerah",
        "kode": "1.02.01"
      },
      "standar_data": "Standar Kementerian Kesehatan RI (e-PPGBM) & SDI",
      "cakupan_wilayah": "Kabupaten Mamasa (17 Kecamatan)"
    },
    "kamus_data": [
      { "variabel": "nama_kecamatan", "tipe_data": "Teks", "satuan": "-" },
      { "variabel": "persentase_prevalensi_stunting", "tipe_data": "Numerik", "satuan": "Persen" }
    ]
  }
}

GET /api/v1/datasets/{slug}/data

Ekstraksi Data Tabular Mentah (JSON)

Menyajikan baris-baris data tabular dalam format JSON array yang siap diproses langsung ke dalam pustaka analisis data seperti Python Pandas, R Dataframe, atau visualisasi grafik di frontend web/mobile.

Contoh Script Pemanggilan:

curl -X GET "https://www.datamamasa.wawandev.my.id/api/v1/datasets/prevalensi-stunting-balita-kabupaten-mamasa-2023/data" \
     -H "Accept: application/json"

async function fetchTableData() {
  const res = await fetch('https://www.datamamasa.wawandev.my.id/api/v1/datasets/prevalensi-stunting-balita-kabupaten-mamasa-2023/data');
  const { records } = await res.json();
  
  // Rekapitulasi per baris
  records.forEach(row => {
    console.log(row.nama_kecamatan, 'Prevalensi:', row.persentase_prevalensi_stunting + '%');
  });
}
fetchTableData();

import pandas as pd
import requests

url = "https://www.datamamasa.wawandev.my.id/api/v1/datasets/prevalensi-stunting-balita-kabupaten-mamasa-2023/data"
res = requests.get(url).json()

# Langsung ubah JSON array ke Pandas DataFrame
df = pd.DataFrame(res["records"])
print(df.head())
print(f"Rata-rata Prevalensi: {df['persentase_prevalensi_stunting'].mean():.2f}%")

use Illuminate\Support\Facades\Http;

$url = 'https://www.datamamasa.wawandev.my.id/api/v1/datasets/prevalensi-stunting-balita-kabupaten-mamasa-2023/data';
$records = Http::get($url)->json('records');

foreach ($records as $item) {
    echo $item['nama_kecamatan'] . ': ' . $item['persentase_prevalensi_stunting'] . '%' . PHP_EOL;
}

Contoh Respon (200 OK):

{
  "status": "success",
  "dataset": "Prevalensi Stunting Balita Menurut Kecamatan di Kabupaten Mamasa Tahun 2023",
  "total_baris": 17,
  "records": [
    {
      "kode_kecamatan": "76.03.01",
      "nama_kecamatan": "Mamasa",
      "jumlah_balita_diukur": 1420,
      "balita_stunting": 245,
      "persentase_prevalensi_stunting": 17.25
    },
    {
      "kode_kecamatan": "76.03.11",
      "nama_kecamatan": "Mambi",
      "jumlah_balita_diukur": 980,
      "balita_stunting": 180,
      "persentase_prevalensi_stunting": 18.37
    }
  ]
}

GET /api/v1/opds

Mengambil seluruh 30 OPD Produsen Data beserta jumlah dataset terbitannya.

curl -X GET "https://www.datamamasa.wawandev.my.id/api/v1/opds"

Detail spesifik: /api/v1/opds/{slug} Coba JSON →

GET /api/v1/topics

Mengambil 8 sektor / topik urusan Satu Data Kabupaten Mamasa.

curl -X GET "https://www.datamamasa.wawandev.my.id/api/v1/topics"

Detail spesifik: /api/v1/topics/{slug} Coba JSON →

GET /api/v1/districts

Daftar 17 kantor kecamatan sebagai produsen data kewilayahan beserta kode Kemendagri.

curl -X GET "https://www.datamamasa.wawandev.my.id/api/v1/districts"

Alias: /api/v1/kecamatan Coba JSON →

GET /api/v1/districts/{code}

Profil lengkap kecamatan, jumlah desa/kelurahan, dan daftar dataset PATEN/kewilayahannya.

curl -X GET "https://www.datamamasa.wawandev.my.id/api/v1/districts/76.03.01"

Menerima kode (76.03.01) atau slug (mamasa) Coba JSON →

Pedoman Kode Status HTTP

API Satu Data Kabupaten Mamasa menggunakan standar kode respon HTTP standar industri:

200 OK

Permintaan berhasil diproses. Data dikembalikan dalam format JSON.

404 Not Found

Dataset, topik, OPD, atau kecamatan dengan slug/kode tersebut tidak ditemukan.

500 Server Error

Terjadi kendala pada peladen internal. Silakan laporkan ke Walidata Diskominfo-SP.