# Dokumentasi API Satu Data Publikasi - Kabupaten Pasuruan

API ini menyediakan data katalog terbuka dalam format [DCAT](https://www.w3.org/TR/vocab-dcat-2/) dan [Project Open Data](https://project-open-data.cio.gov/) untuk Kabupaten Pasuruan.

---

## Ringkasan

- **Base URL:** `https://satudata.pasuruankab.go.id/api`

- **Respons utama:** JSON sesuai standar DCAT Project Open Data

- **Versi:** 1.0.0

---

## Endpoint

### 1. Ambil Katalog Data Terbuka

- **URL:** `/opendata/catalog`

- **Method:** `GET`

- **Deskripsi:** Mengembalikan seluruh katalog data terbuka Kabupaten Pasuruan dalam format DCAT (Project Open Data JSON).

#### Contoh Request

```http

GET https://satudata.pasuruankab.go.id/api/opendata/catalog

Accept: application/json

```

#### Contoh Response

```json

{

  "@context": "https://project-open-data.cio.gov/v1.1/schema/catalog.jsonld",

  "@id": "https://satudata.pasuruankab.go.id",

  "@type": "dcat:Catalog",

  "conformsTo": "https://project-open-data.cio.gov/v1.1/schema",

  "describedBy": "https://project-open-data.cio.gov/v1.1/schema/catalog.json",

  "dataset": [

    {

      "@type": "dcat:Dataset",

      "accessLevel": "public",

      "contactPoint": {

        "fn": "Wali Data Kabupaten Pasuruan",

        "hasEmail": "mailto:satudata@pasuruankab.go.id"

      },

      "distribution": [

        {

          "@type": "dcat:Distribution",

          "downloadURL": "https://satudata.pasuruankab.go.id/download/eyJpdiI6Ik1XMm5zWGtkelhWN2hkS0dYQmQ2akE9PSIsInZhbHVlIjoiYlJkNktNRlZVeDRjUGhHOGdWWlhqUT09IiwibWFjIjoiYTI2ZWE2YTg1NzM1Y2Q4NmU3NDA1MGFiYzYxZGZhZjYxYTAwYmY3NWIxOThlMTRmMzczNjU4NzdhYTRkODE5ZiIsInRhZyI6IiJ9/xlsx",

          "mediaType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",

          "format": "xlsx",

          "title": "Populasi Ternak Tahun 2023"

        }

      ],

      "identifier": "568a715b8b152f903150646a9e92e3ec",

      "issued": "2024-12-06",

      "keyword": [

        "Populasi",

        "Ternak",

        "tahun",

        "2023",

        "pendukung",

        "sasaran",

        "pd",

        "kabupaten",

        "pasuruan",

        "kompilasi"

      ],

      "landingPage": "https://satudata.pasuruankab.go.id/data/eyJpdiI6ImRrY0hIWjBqQ1Y3MjVBWWlUWDAyTXc9PSIsInZhbHVlIjoiOW1iT2ErSlhXZTZ0RVJybVdRcjFLQT09IiwibWFjIjoiNGQ1NGU3NDBlOTA5ODc4Y2U3ZDIxYTQ0OTdlMGEyM2E4NmE3Y2JjNjA2MDVlZmU4OTA1NWE5MDkwMzQ0ZTVmZSIsInRhZyI6IiJ9",

      "kategori": "Ekonomi",

      "modified": "2025-06-05",

      "accrualPeriodicity": "tahunan",

      "publisher": {

        "@type": "org:Organization",

        "name": "DINAS PETERNAKAN DAN KESEHATAN HEWAN"

      },

      "theme": [

        "Ekonomi"

      ],

      "title": "Populasi Ternak Tahun 2023",

      "description": "Populasi Ternak Tahun 2023"

    }

    // ... dataset lain

  ]

}

```

---

## Penjelasan Struktur Respons

- `@context`: Selalu mengacu pada schema Project Open Data.

- `@id`: URL utama katalog data.

- `@type`: Jenis katalog (`dcat:Catalog`).

- `conformsTo`, `describedBy`: Standar dan dokumentasi schema.

- `dataset`: Array daftar dataset publik.

- **Setiap dataset berisi:**

    - `accessLevel`: Tingkat akses (public).

    - `contactPoint`: Kontak pengelola data.

    - `distribution`: Array format file yang tersedia (misal XLSX, CSV, dsb).

    - `identifier`: Hash unik dataset.

    - `issued`, `modified`: Tanggal rilis dan update terakhir dataset.

    - `keyword`: Array kata kunci.

    - `landingPage`: URL landing data.

    - `kategori`: Kategori data.

    - `accrualPeriodicity`: Periode update data (misal tahunan).

    - `publisher`: Instansi penerbit.

    - `theme`: Tema data.

    - `title`, `description`: Judul dan deskripsi dataset.

---

## Swagger / OpenAPI

Lihat file [swagger-opendata.json](swagger-opendata.json) untuk spesifikasi OpenAPI/Swagger lengkap.

---

## Autentikasi

- Endpoint ini bersifat publik dan tidak membutuhkan autentikasi.

---

## Kontak

- **Nama:** Wali Data Kabupaten Pasuruan

- **Email:** satudata@pasuruankab.go.id

---

## Lisensi

- Data tersedia di bawah lisensi [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/)

---

## Sumber

- [Project Open Data Schema](https://project-open-data.cio.gov/v1.1/schema/)

- [W3C DCAT Recommendation](https://www.w3.org/TR/vocab-dcat-2/)

---

## FAQ

**Q: Apakah data bisa diunduh dalam format lain selain XLSX?**  

A: Jika tersedia, format lain (CSV, JSON) akan muncul di property `distribution`.

**Q: Bagaimana mencari dataset tertentu?**  

A: Gunakan fitur pencarian pada portal utama atau filter pada landing catalog.

**Q: Apakah API ini menyediakan endpoint selain katalog?**  

A: Saat ini hanya endpoint katalog publik. Untuk data detail, gunakan landingPage pada masing-masing dataset.

---

## Changelog

- **2025-06-05:** Dokumentasi awal dibuat.