Kurulum Platform Sahibi Ücretini Oluştur veya Güncelle

Platform sahibinin tek bir kurulumdan ne aldığını (entity 2, kuruluma kapsamlı ve kurulumun ağıyla damgalı) oluşturur ya da değiştirir. Bu ucu yalnızca platform sahibi düğümün kendi API anahtarı çağırabilir; diğer her anahtar 403 alır. Kurulum o düğüme ait olmalıdır. Bkz. Ücretlere Genel Bakış.

Satır hemen kaydedilir ve döner. Kurulum dağıtılmışsa ve bu onun ilk platform sahibi override'ıysa ya da oranlar değiştiyse yeni ücret o kurulumun kontratlarına asenkron olarak gönderilir: platform sahibinin düğümünde, platform sahibinin kurulumun zincirindeki cüzdanıyla imzalanan 12 (UpdateDefaultNodeFeeByPlatformOwner) tipinde bir düğüm işlemi başlatılır. Bunu Get Node Transactions ile sorgulayın. Henüz dağıtılmamış bir kurulumda satır yalnızca kaydedilir ve dağıtım onu kullanır. Yalnızca categories değişikliği gönderim başlatmaz.

Gerekli izin: fee:upsert

İstek

PUT /v2/admin/fees/nodes/{node_id}/setups/{setup_id}/platform-owner

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	path	Zorunlu. Kurulumun sahibi olan düğüm
setup_id	string	path	Zorunlu. Kurulum ID'si

Başlıklar

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

Gövde

Alan	Tip	Zorunlu	Açıklama
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/setups/6a552db09c6088e126a4be87/platform-owner' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": {
      "tokenization": {
        "asset_tokenization": { "value": "2.1" },
        "tokenized_asset_sales": { "value": "1.1" },
        "management": { "value": "1.2" }
      },
      "secondary_market": {
        "buy_order": { "value": "1.3" },
        "sell_order": { "value": "1.4" },
        "otc_sale": { "value": "1.5" }
      },
      "lending": {
        "borrower": { "value": "1.6" },
        "lending": { "value": "1.7" },
        "liquidation": { "value": "1.8" }
      }
    },
    "categories": null
  }'

Yanıt

{
  "id": "6a553c449c6088e126a4bea7",
  "entity": 2,
  "node_id": "6a4bef2b1e781b11c22e9707",
  "setup_id": "6a552db09c6088e126a4be87",
  "network_id": "6a4bf0a21e781b11c22e9712",
  "value": {
    "tokenization": {
      "asset_tokenization": { "id": 0, "value": "2.1" },
      "tokenized_asset_sales": { "id": 0, "value": "1.1" },
      "management": { "id": 0, "value": "1.2" }
    },
    "secondary_market": {
      "buy_order": { "id": 0, "value": "1.3" },
      "sell_order": { "id": 0, "value": "1.4" },
      "otc_sale": { "id": 0, "value": "1.5" }
    },
    "lending": {
      "borrower": { "id": 0, "value": "1.6" },
      "lending": { "id": 0, "value": "1.7" },
      "liquidation": { "id": 0, "value": "1.8" }
    }
  },
  "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
setup_id	string	Path'teki kurulum
network_id	string	Kurulumun ağı
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. Hatalı biçimli bir oran da burada bildirilir
400	10016	node_id veya setup_id 24 karakterlik bir hex ID değil
400	10001 (domain 2)	Düğüm bulunamadı ya da kurulum o düğüme ait değil
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.