Panduan API untuk Website OPD

curl -H "X-API-Key: KUNCI_OPD_ANDA" \
  "https://ppid.nunukankab.go.id/api/v1/informasi?per_halaman=5"

<?php
// Simpan kunci di pengaturan server (mis. variabel lingkungan
// PPID_API_KEY), bukan di dalam kode.
$portal = 'https://ppid.nunukankab.go.id';
$kunci  = getenv('PPID_API_KEY');

$ch = curl_init($portal . '/api/v1/informasi?per_halaman=10');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => ['X-API-Key: ' . $kunci],
  CURLOPT_TIMEOUT        => 10,
]);
$hasil = json_decode(curl_exec($ch), true);
curl_close($ch);

echo '<ul class="informasi-publik">';
foreach ($hasil['data'] ?? [] as $info) {
  echo '<li><strong>' . htmlspecialchars($info['judul']) . '</strong>';
  echo ' (' . htmlspecialchars($info['klasifikasi']['label']) . ', ' . $info['tahun'] . ')';
  if (!empty($info['berkas'])) {
    $unduh = $portal . $info['berkas']['url'];
    echo ' <a href="' . htmlspecialchars($unduh) . '">Unduh PDF</a>';
  }
  echo '</li>';
}
echo '</ul>';

// Node.js 18+ / Next.js (dijalankan di server, bukan di browser)
const portal = "https://ppid.nunukankab.go.id";

export async function ambilInformasi() {
  const res = await fetch(portal + "/api/v1/informasi?per_halaman=10", {
    headers: { "X-API-Key": process.env.PPID_API_KEY },
    // Simpan sementara 10 menit agar hemat kuota.
    next: { revalidate: 600 },
  });
  if (!res.ok) throw new Error("Gagal mengambil data PPID: " + res.status);
  const { data } = await res.json();
  return data.map((info) => ({
    judul: info.judul,
    tahun: info.tahun,
    unduh: info.berkas ? portal + info.berkas.url : null,
  }));
}

<?php
// Dipanggil saat formulir permohonan di website OPD dikirim.
$portal = 'https://ppid.nunukankab.go.id';
$kunci  = getenv('PPID_API_KEY');

$isian = [
  'namaPemohon'      => $_POST['namaPemohon'],
  'nik'              => $_POST['nik'],
  'email'            => $_POST['email'],
  'telepon'          => $_POST['telepon'],
  'alamat'           => $_POST['alamat'],
  'rincianInformasi' => $_POST['rincianInformasi'],
  'tujuanPenggunaan' => $_POST['tujuanPenggunaan'],
  'jenisPemohon'     => 'perorangan',
  'caraMendapatkan'  => 'email',
  'caraMemperoleh'   => 'softcopy',
  // Dokumen wajib sesuai jenis pemohon (lihat /api/v1/referensi).
  'dokumen_ktp'      => new CURLFile(
    $_FILES['ktp']['tmp_name'], $_FILES['ktp']['type'], $_FILES['ktp']['name']
  ),
];

$ch = curl_init($portal . '/api/v1/permohonan');
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_POSTFIELDS     => $isian, // otomatis multipart/form-data
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    'X-API-Key: ' . $kunci,
    // UUID per pengisian formulir: aman bila pengiriman diulang.
    'Idempotency-Key: ' . $_POST['kunci_formulir'],
  ],
  CURLOPT_TIMEOUT        => 30,
]);
$hasil  = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status === 201 || $status === 200) {
  echo 'Permohonan terkirim. Kode tiket Anda: '
    . htmlspecialchars($hasil['data']['kodeTiket']);
} else {
  // 422: tampilkan pesan per isian dari $hasil['error']['details'].
  foreach ($hasil['error']['details'] ?? [] as $galat) {
    echo '<p>' . htmlspecialchars($galat['message']) . '</p>';
  }
}

curl -H "X-API-Key: KUNCI_OPD_ANDA"   "https://ppid.nunukankab.go.id/api/v1/permohonan/PPID-2026-00042?email=pemohon@contoh.id"