Pohon Navigasi

Membaca dan menyusun ulang struktur halaman satu space.

Di halaman ini

GET /tree

Bash

curl -u "$USER:$APP_PASSWORD" "https://situs.id/wp-json/gitdocs/v1/tree?space=2"

JSON

{
    "space": 2,
    "nodes": [
        { "id": 10, "parent": 0,  "order": 1, "title": "Selamat Datang", "icon": "👋", "isGroup": false, "status": "publish", "hasDraft": false, "canEdit": true },
        { "id": 14, "parent": 0,  "order": 3, "title": "Memulai",        "icon": "",   "isGroup": true,  "status": "publish", "hasDraft": false, "canEdit": true },
        { "id": 22, "parent": 14, "order": 1, "title": "Instalasi",      "icon": "📦", "isGroup": false, "status": "draft",   "hasDraft": true,  "canEdit": true }
    ]
}

Daftar ini datar: hierarki dibentuk dari parent, dan urutan tiap tingkat dari order. Semua status disertakan (termasuk draf), karena endpoint ini untuk editor.

POST /tree

Mengirim seluruh struktur sekaligus. Server hanya menulis baris yang benar-benar berubah.

Bash

curl -u "$USER:$APP_PASSWORD" -H "Content-Type: application/json" \
  -X POST https://situs.id/wp-json/gitdocs/v1/tree \
  -d '{
    "space": 2,
    "items": [
      { "id": 10, "parent": 0,  "order": 1 },
      { "id": 14, "parent": 0,  "order": 2 },
      { "id": 22, "parent": 14, "order": 1 }
    ]
  }'

Aturan

Setiap id harus berada di space yang dikirim.
parent harus 0 atau id lain di dalam space yang sama.
Siklus ditolak dengan gitdocs_cycle (400).
Pengguna harus memiliki edit_post untuk setiap halaman yang berubah, jika tidak permintaan ditolak seluruhnya.

Efek samping yang disengaja

Hal	Perilaku
Tanggal "Diperbarui pada"	Tidak berubah — memindahkan bukan menyunting
Revisi	Tidak dibuat
Slug	Disesuaikan bila bentrok dengan saudara baru
URL lama	Disimpan dan dialihkan 301
Indeks pencarian	Dibangun ulang (jalur remah roti ikut berubah)

Karena POST /tree bersifat idempoten, klien dapat mengirim ulang struktur yang sama dengan aman — misalnya untuk memulihkan urutan setelah kegagalan jaringan.

Space

Bash

# Daftar space
curl … https://situs.id/wp-json/gitdocs/v1/spaces

# Buat space
curl … -X POST …/spaces -d '{"name":"Panduan Internal","icon":"🔒"}'

# Perbarui space
curl … -X POST …/spaces/3 -d '{"description":"Hanya untuk tim.","order":2}'

JSON

{
    "id": 2,
    "name": "Panduan",
    "slug": "panduan",
    "description": "Panduan lengkap menulis dokumentasi.",
    "icon": "📘",
    "order": 1,
    "url": "https://situs.id/docs/panduan/",
    "count": 16
}

Membuat atau mengganti nama space mengubah aturan URL. GitDocs menjadwalkan penyegaran permalink otomatis, namun bila Anda menambahkannya lewat SQL langsung, jalankan wp rewrite flush.