Düğüm Oluştur

Bir üst düğümün altında yeni bir düğüm (node) oluşturur. Düğüm tipini çağıran seçmez; tip üst düğümden gelir: platform düğümünün alt düğümü bir account (2), bir account'un ya da sub-account'un alt düğümü bir sub-account (3) olur.

Üst düğüm aktif olmalı ve sizin kendi düğümünüz ya da onun altındaki bir düğüm olmalıdır. Account düğümü 3 (Creating) durumunda ve cüzdansız başlar: Düğüm Cüzdanı Oluştur ile bir cüzdan oluşturun, ardından Düğüm Kurulumu Oluştur ile bir kurulum (setup) açın. Sub-account aktif (1) başlar.

Gerekli izin: node:create

İstek

POST /v2/admin/nodes

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
name	string	Evet	Düğüm adı
parent_id	string	Evet	Üst düğümün kimliği

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/admin/nodes' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "parent_id": "665ae536a6392b75cfd40352",
    "name": "Tostik 5"
  }'

Yanıt

Yeni düğümle birlikte 201 Created:

{
  "id": "6a4bef2b1e781b11c22e9707",
  "parent_id": "665ae536a6392b75cfd40352",
  "parent_name": null,
  "name": "Tostik 5",
  "type": 2,
  "status": 3,
  "contract": null,
  "meta": null,
  "int_id": 38,
  "path": "1.38",
  "listed_token_count": 0,
  "supervisor_count": 0,
  "created_by": "665b372f3a72d7d0791596ba",
  "created_by_supervisor": {
    "id": "665b372f3a72d7d0791596ba",
    "name": "Jane",
    "surname": "Doe",
    "email": "admin@example.com"
  },
  "created_at": "2026-03-16T12:29:59.46Z"
}

Yanıt Alanları

Yanıt bir düğüm nesnesidir; alanları, düğüm tipi ve durum değerleriyle birlikte tek tek Düğüm Al sayfasında açıklanmıştır. Bu yanıtta parent_name her zaman null olur.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (eksik name veya parent_id) — details alanına bakın
400	10016	parent_id geçerli bir kimlik değil
400	10003	Üst düğüm bulunamadı (düğüm domain'i 2)
400	10020	Üst düğüm aktif değil (düğüm domain'i 2)
403	10005	Üst 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.