Düğüm Torunlarını Listele

Bir düğümün (node) altındaki tüm düğümleri, düğümün kendisi hariç, en yeniden eskiye ve sayfalı olarak listeler. Liste düzdür; bu yüzden her satır, ağacı yeniden dolaşmadan nerede durduğunu göstermek için path_name taşır: üst düğümlerin ve düğümün kendisinin adları, kökten başlayarak / ile birleştirilmiş. Yalnızca doğrudan alt düğümler için Alt Düğümleri Listele kullanın.

Gerekli izin: node:descendants:view

İstek

GET /v2/admin/nodes/{node_id}/descendants

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	path	Zorunlu. Alt ağacı listelenecek düğüm
search	string	query	Düğüm adında büyük/küçük harf duyarsız kısmi eşleşme
depth	integer	query	Düğümün kaç seviye altına inileceği, 1–20. Düğüme görelidir; 1 yalnızca alt düğümleri verir. Varsayılan 10
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar
per_page	integer	query	Zorunlu. Sayfa başına kayıt, 1–100

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/nodes/665ae536a6392b75cfd40352/descendants?depth=2&page=1&per_page=20' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "6a5c1e9b2f4d8a0012ab34cd",
      "parent_id": "6a4bef2b1e781b11c22e9707",
      "parent_name": null,
      "name": "Tostik 5 Branch",
      "type": 3,
      "status": 1,
      "contract": null,
      "meta": null,
      "int_id": 41,
      "path": "1.38.41",
      "listed_token_count": 0,
      "supervisor_count": 0,
      "created_at": "2026-04-02T08:11:20.12Z",
      "path_name": "Apex / Tostik 5 / Tostik 5 Branch"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Torun düğümler. Her satır Düğüm Al sayfasındaki düğüm alanlarını taşır; farklar aşağıdadır
data[].path_name	string	Düğümün üst düğümlerinin ve kendisinin adları, kökten başlayarak / ile birleştirilmiş
data[].parent_name	null	Bu listede her zaman null
data[].listed_token_count	integer	Bu listede her zaman 0; sayı için düğümü Düğüm Al ile okuyun
data[].supervisor_count	integer	Bu listede her zaman 0; sayı için düğümü Düğüm Al ile okuyun
data[].created_by_supervisor	—	Bu listede yer almaz (created_by yer alır)
total	integer	Filtrelere uyan torun sayısı
page	integer	Sayfa numarası
per_page	integer	Sayfa başına kayıt

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (örneğin 1–20 dışında depth ya da eksik page) — details alanına bakın
400	10016	node_id geçerli bir kimlik değil
400	10001	Düğüm bulunamadı (düğüm domain'i 2)
403	10005	Düğüm, hiyerarşide sizin erişebildiğiniz kısmın dışında (düğüm domain'i 2)

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.