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

Platform sahibinin tek bir düğümden ne aldığını (entity 2) oluşturur ya da değiştirir: tüm ağlarda veya gövde network_id taşıyorsa tek bir ağda. Bu ucu yalnızca platform sahibi düğümün kendi API anahtarı çağırabilir; diğer her anahtar 403 alır.

Satır hemen kaydedilir ve döner. Zincire gönderim asenkrondur: düğümün (network_id verilmişse o ağdaki) geçerli platform sahibi ücreti değişen her dağıtılmış kurulumu için platform sahibinin düğümünde düğüm işlemleri (12, 13 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}/platform-owner

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	path	Zorunlu. Platform sahibinin ücret aldığı 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ğlarda geçerli 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

Örnek

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

Yanıt

{
  "id": "6a553a0e9c6088e126a4bea3",
  "entity": 2,
  "node_id": "6a4bef2b1e781b11c22e9707",
  "value": {
    "tokenization": {
      "asset_tokenization": { "id": 0, "value": "2" },
      "tokenized_asset_sales": { "id": 0, "value": "2" },
      "management": { "id": 0, "value": "2" }
    },
    "secondary_market": {
      "buy_order": { "id": 0, "value": "2" },
      "sell_order": { "id": 0, "value": "2" },
      "otc_sale": { "id": 0, "value": "2" }
    },
    "lending": {
      "borrower": { "id": 0, "value": "2" },
      "lending": { "id": 0, "value": "2" },
      "liquidation": { "id": 0, "value": "2" }
    }
  },
  "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
entity	integer	2 (platform sahibi)
node_id	string	Path'teki düğüm
network_id	string	Gövdedeki ağ. Tüm ağlarda geçerli 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	10003 (domain 9)	Anahtar platform sahibi düğüme ait değil
500	10000	Beklenmeyen sunucu hatası

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