Alt Düğümleri Listele
Bir düğümün (node) doğrudan alt düğümlerini en yeniden eskiye, sayfalı olarak listeler. Bir düğümün altındaki her derinlikteki tüm düğümler için Düğüm Torunlarını Listele kullanın.
Gerekli izin: node:children:view
İstek
GET /v2/admin/nodes/{node_id}/children
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
node_id | string | path | Zorunlu. Üst düğümün kimliği |
name | string | query | Alt düğüm adında büyük/küçük harf duyarsız kısmi eşleşme |
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/children?page=1&per_page=20' \
--header 'Authorization: Bearer <access_token>'
Yanıt
{
"data": [
{
"id": "6a4bef2b1e781b11c22e9707",
"parent_id": "665ae536a6392b75cfd40352",
"parent_name": null,
"name": "Tostik 5",
"type": 2,
"status": 2,
"contract": null,
"meta": null,
"int_id": 38,
"path": "1.38",
"listed_token_count": 3,
"supervisor_count": 2,
"created_by": "665b372f3a72d7d0791596ba",
"created_at": "2026-03-16T12:29:59.46Z"
}
],
"total": 1,
"page": 1,
"per_page": 20
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
data | array | Alt düğümler. Her satır Düğüm Al sayfasındaki düğüm alanlarını taşır; farklar aşağıdadır |
data[].parent_name | null | Bu listede her zaman null |
data[].status | integer | Saklanan düğüm durumu değildir, aşağıdaki nota bakın |
data[].created_by_supervisor | — | Bu listede yer almaz (created_by yer alır) |
total | integer | Filtreye uyan alt düğüm sayısı |
page | integer | Sayfa numarası |
per_page | integer | Sayfa başına kayıt |
Bu listedeki
statusBu liste her alt düğümün durumunu türetilmiş bir değerle değiştirir: alt düğümün eski gömülü sözleşme kümesi eksiksizse 1, değilse 2. Sözleşmeler artık kurulumlarda (setup) tutulduğu için şu anda her satır 2 döner. Bir alt düğümün gerçek durumu için onu Düğüm Al ile okuyun.
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | Doğrulama başarısız (örneğin eksik page veya per_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.