Düğüm Ücretini Oluştur veya Güncelle

Bir düğümün kendi ücretini (entity 3) tek bir kurulumdan daha geniş bir kapsamda oluşturur ya da değiştirir: düğüm genelindeki satır veya gövde network_id taşıyorsa düğümün tek bir ağdaki satırı. Düğüm API anahtarınızın düğüm alt ağacında olmalıdır. Kurulum bazlı override bunun yerine Kurulum Ücretini Oluştur veya Güncelle ile yazılır.

Satır hemen kaydedilir ve döner. Zincire gönderim asenkrondur: düğümün (network_id verilmişse o ağdaki) geçerli ücreti değişen her dağıtılmış kurulumu için düğümde düğüm işlemleri (10, 11 tipleri) başlatılır. Bunun kaç kurulum olduğunu görmek için önce Etkilenen Kurulum Sayısını Al çağrısını yapın, sonucu Get Node Transactions ile sorgulayın. Bkz. Ücretlere Genel Bakış.

Gerekli izin: fee:upsert

İstek

PUT /v2/admin/fees/nodes/{node_id}

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	path	Zorunlu. Ücreti yazılan düğüm

Başlıklar

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

Gövde

Alan	Tip	Zorunlu	Açıklama
network_id	string veya null	Hayır	Satırın kapsamlanacağı ağ. Tüm ağların geri düştüğü düğüm genelindeki satır için göndermeyin ya da null gönderin. Ağ mevcut olmalıdır
value	object	Evet	Dokuz oran. Dokuz yaprağın tamamı zorunludur: tokenization.asset_tokenization, tokenization.tokenized_asset_sales, tokenization.management, secondary_market.buy_order, secondary_market.sell_order, secondary_market.otc_sale, lending.borrower, lending.lending, lending.liquidation
value.<group>.<leaf>.value	string	Evet	Yüzde olarak oran, "0" ile "100" arası, en fazla bir ondalık (örneğin "2.5"). Bkz. Tutarlar ve Yüzdeler
categories	array veya null	Hayır	Varlık kategorisi bazlı override'lar. Bir üst kategoriye verilen override, yaprak kategorilerine uygulanır
categories[].id	string	Evet	Kategori ID'si (24 karakter hex)
categories[].value	object	Evet	Bu kategorinin oranları, value ile aynı biçimde

Kapsam yalnızca route'tan ve network_id'den alınır: gövdedeki entity, node_id veya platform_owner_id yok sayılır.

Örnek

curl --request PUT \
  --url '{{baseUrl}}/v2/admin/fees/nodes/6a4bef2b1e781b11c22e9707' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "network_id": "6a4bf0a21e781b11c22e9712",
    "value": {
      "tokenization": {
        "asset_tokenization": { "value": "2.5" },
        "tokenized_asset_sales": { "value": "1" },
        "management": { "value": "0.5" }
      },
      "secondary_market": {
        "buy_order": { "value": "1" },
        "sell_order": { "value": "1" },
        "otc_sale": { "value": "1.5" }
      },
      "lending": {
        "borrower": { "value": "0" },
        "lending": { "value": "0" },
        "liquidation": { "value": "0" }
      }
    },
    "categories": null
  }'

Yanıt

{
  "id": "680be1f55d63bcee848d38e7",
  "entity": 3,
  "node_id": "6a4bef2b1e781b11c22e9707",
  "network_id": "6a4bf0a21e781b11c22e9712",
  "value": {
    "tokenization": {
      "asset_tokenization": { "id": 0, "value": "2.5" },
      "tokenized_asset_sales": { "id": 0, "value": "1" },
      "management": { "id": 0, "value": "0.5" }
    },
    "secondary_market": {
      "buy_order": { "id": 0, "value": "1" },
      "sell_order": { "id": 0, "value": "1" },
      "otc_sale": { "id": 0, "value": "1.5" }
    },
    "lending": {
      "borrower": { "id": 0, "value": "0" },
      "lending": { "id": 0, "value": "0" },
      "liquidation": { "id": 0, "value": "0" }
    }
  },
  "categories": null
}

Yanıt Alanları

Kaydedilen ücret satırı, ID ile Ücret Al ile aynı biçimde.

Alan	Tip	Açıklama
id	string	Ücret satırı ID'si. ID ile Ücret Güncelle ile kullanın
entity	integer	3 (düğüm)
node_id	string	Path'teki düğüm
network_id	string	Gövdedeki ağ. Düğüm genelindeki satırda gelmez
value	object	Kaydedilen oranlar. Her yaprak { "id": 0, "value": "<percent>" } biçimindedir
categories	array veya null	Yaprak kategorilere açılmış, kaydedilen kategori override'ları (id, int_id, path, value)

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın. network_id hiçbir ağa karşılık gelmediğinde ve hatalı biçimli bir oranda da döner
400	10016	node_id veya network_id 24 karakterlik bir hex ID değil
400	10001 (domain 2)	Düğüm bulunamadı
400	10002 (domain 9)	value dokuz oranın tamamını içermiyor
400	10001 (domain 4)	Bir categories[].id mevcut değil
403	10005 (domain 2)	Düğüm, API anahtarınızın düğüm alt ağacının dışında
500	10000	Beklenmeyen sunucu hatası

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