API ini memungkinkan aplikasi lain (skrip otomatis, CMS pihak ketiga, automation tool, atau layanan AI) membuat artikel dan mengunggah gambar ke Haijakarta.id tanpa membuka panel CMS. Semua permintaan dan respons memakai JSON.

1. Minta administrator membuka CMS → User → Edit pada akun Anda, lalu di kartu API Key klik Buat API Key. Salin key-nya, karena hanya tampil sekali.
2. Simpan key sebagai variabel lingkungan, misalnya API_KEY. Jangan menaruhnya di kode front-end atau repositori publik.
3. Cek key dengan memanggil GET /me, lalu kirim artikel pertama dengan POST /articles.

curl "https://staging.haijakarta.id/api/v1/me" \
  -H "Authorization: Bearer $API_KEY"

Kirim API key pada setiap permintaan lewat header Authorization dengan skema Bearer. Header X-API-Key: <key> juga diterima sebagai alternatif.

Authorization: Bearer pn_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

• Key diawali pn_live_ dan terikat pada satu user. Artikel yang dibuat tercatat atas nama user tersebut.
• Key memiliki izin yang sama dengan pemiliknya. Contoh: user dengan level Author hanya bisa membuat draft, sedangkan Editor boleh langsung mempublikasikan.
• Key bisa dicabut kapan saja dari halaman edit user. Key juga berhenti berfungsi jika akun pemiliknya dinonaktifkan.
• Di server kami hanya tersimpan hash dari key. Jika key hilang, buat yang baru.

• Kirim body JSON dengan header Content-Type: application/json (kecuali unggah gambar yang memakai multipart/form-data).
• Semua respons berbentuk { "success": true | false, ... }.
• Waktu memakai ISO 8601 (UTC pada respons). Untuk scheduled_at sertakan zona waktu, mis. +07:00.
• Batas 60 permintaan per menit per API key. Sisa kuota ada di header X-RateLimit-Limit dan X-RateLimit-Remaining. Jika terlampaui Anda menerima 429 beserta header Retry-After (detik).

Saat gagal, respons berformat:

{
  "success": false,
  "message": "Validasi gagal.",
  "errors": { "title": "title wajib diisi." }
}

Menampilkan pemilik key dan daftar izinnya. Berguna untuk memverifikasi bahwa key bekerja.

curl "https://staging.haijakarta.id/api/v1/me" \
  -H "Authorization: Bearer $API_KEY"

{
  "success": true,
  "data": {
    "id": 3,
    "name": "Redaksi Bot",
    "username": "bot",
    "email": "bot@example.com",
    "access_level": "Editor",
    "permissions": ["articles.view", "articles.create", "articles.publish", "media.upload"]
  }
}

Daftar kategori aktif. Gunakan id atau slug-nya pada POST /articles.

curl "https://staging.haijakarta.id/api/v1/categories" \
  -H "Authorization: Bearer $API_KEY"

{
  "success": true,
  "data": [
    { "id": 1, "name": "Berita", "slug": "berita" },
    { "id": 2, "name": "Ekonomi", "slug": "ekonomi" }
  ]
}

Daftar tag aktif. Anda juga bisa langsung mengirim nama tag pada POST /articles tanpa memanggil endpoint ini.

curl "https://staging.haijakarta.id/api/v1/tags" \
  -H "Authorization: Bearer $API_KEY"

{
  "success": true,
  "data": [{ "id": 5, "name": "Taman Kota", "slug": "taman-kota" }]
}

Mengunggah satu gambar ke Media Library. Hasilnya (url) dipakai sebagai featured_image atau og_image. Format: JPG, PNG, WEBP, SVG; maksimal 5 MB. Gambar raster dikonversi ke WEBP dan ukurannya dibatasi 2400 px.

curl -X POST "https://staging.haijakarta.id/api/v1/media" \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@./cover.jpg"

{
  "success": true,
  "message": "Gambar berhasil diupload",
  "data": {
    "id": 12,
    "url": "/uploads/2026/10/a1b2c3-taman-kota.webp",
    "absolute_url": "https://staging.haijakarta.id/uploads/2026/10/a1b2c3-taman-kota.webp",
    "mime_type": "image/webp",
    "size": 184320,
    "width": 1600,
    "height": 900
  }
}

Membuat artikel baru atas nama pemilik key. Konten disanitasi di server (lihat Konten HTML), slug dibuat otomatis dari judul dan dijamin unik.

Body

curl -X POST "https://staging.haijakarta.id/api/v1/articles" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Pemkot Resmikan Taman Kota Baru",
  "content": "<p>Taman seluas dua hektare itu resmi dibuka...</p><h2>Fasilitas</h2><p>Jogging track, area bermain...</p>",
  "excerpt": "Taman seluas dua hektare resmi dibuka untuk umum.",
  "status": "published",
  "category": "berita",
  "tags": ["Taman Kota", "Pemkot"],
  "featured_image": "/uploads/2026/10/a1b2c3-taman-kota.webp",
  "meta_title": "Taman Kota Baru Resmi Dibuka",
  "meta_description": "Pemkot meresmikan taman kota baru seluas dua hektare."
}'

{
  "success": true,
  "message": "Artikel berhasil dibuat",
  "data": {
    "id": 42,
    "title": "Pemkot Resmikan Taman Kota Baru",
    "slug": "pemkot-resmikan-taman-kota-baru",
    "status": "published",
    "url": "https://staging.haijakarta.id/pemkot-resmikan-taman-kota-baru",
    "admin_url": "https://staging.haijakarta.id/marimo/articles?edit=42",
    "category": { "id": 7, "name": "Berita", "slug": "berita", "created": false },
    "published_at": "2026-10-29T13:45:10.000Z",
    "scheduled_at": null,
    "created_at": "2026-10-29T13:45:10.000Z"
  }
}

url bernilai null untuk draft karena artikel belum tampil publik. Header Location berisi alamat artikel.

Kategori otomatis

Objek category pada respons menunjukkan kategori yang dipakai (null bila artikel dikirim tanpa kategori). created: true berarti kategori tersebut baru dibuat oleh permintaan ini. Aturannya:

• Pencocokan memakai slug atau nama, jadi Kesehatan Ibu, kesehatan ibu, dan kesehatan-ibu menunjuk ke kategori yang sama.
• Kategori baru dibuat dengan slug dari namanya dan berstatus aktif. Aktivitasnya tercatat di Activity Log CMS.
• Tanpa izin categories.create, permintaan ditolak 403 dan tidak ada kategori yang dibuat. Memakai kategori yang sudah ada tetap diperbolehkan.
• Jika artikelnya ditolak (mis. validasi gagal), kategori yang baru dibuat oleh permintaan itu dibatalkan.
• Kategori yang ada tetapi nonaktif ditolak 422 agar tidak terbentuk kategori ganda.

{
  "success": false,
  "message": "Validasi gagal.",
  "errors": {
    "title": "title wajib diisi.",
    "scheduled_at": "scheduled_at harus ISO 8601 dengan zona waktu, mis. 2026-11-01T08:00:00+07:00."
  }
}

Field content berisi HTML. Demi keamanan, server membersihkan konten sebelum disimpan: tag, atribut, dan skema URL di luar daftar berikut dibuang (termasuk <script>, atribut on*, dan tautan javascript:).

• Tag: h2 h3 h4 p br hr strong b em i u s a ul ol li blockquote pre code img figure figcaption div span, serta iframe hanya untuk YouTube dan Vimeo.
• Atribut: href (+ target, rel) pada link, src alt width height pada gambar, dan text-align pada gaya.
• Skema URL: http, https, mailto, tel. Link eksternal otomatis dibuka di tab baru dengan rel="noopener noreferrer".
• Gunakan <h2> dan seterusnya untuk subjudul. Judul utama (h1) berasal dari field title.

• v1: rilis awal dengan /me, /categories, /tags, /media, dan /articles (POST).