Platform Sahibi Ücretini Oluştur veya Güncelle

Platform sahibinin varsayılan ücretini oluşturur ya da değiştirir: düğümü ve kurulumu olmayan entity 2 satırı (bkz. Ücretlere Genel Bakış). 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. Zaten dağıtılmış kurulumlara gönderilmez; sonradan dağıtılan kurulumlar onu dağıtım anında çözümler. Platform sahibinin bir düğümün dağıtılmış kurulumlarından ne alacağını değiştirmek için Düğüm Platform Sahibi Ücretini Oluştur veya Güncelle ya da Kurulum Platform Sahibi Ücretini Oluştur veya Güncelle ucunu kullanın.

Gerekli izin: fee:upsert

İstek

PUT /v2/admin/fees/platform-owner

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

Kapsam yalnızca route'tan alınır: gövdedeki entity, node_id veya platform_owner_id yok sayılır. Bir yaprak içinde gönderilen id de yok sayılır.

Örnek

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

Yanıt

{
  "id": "680be1f55d63bcee848d38e8",
  "entity": 2,
  "value": {
    "tokenization": {
      "asset_tokenization": { "id": 0, "value": "1" },
      "tokenized_asset_sales": { "id": 0, "value": "1" },
      "management": { "id": 0, "value": "0.5" }
    },
    "secondary_market": {
      "buy_order": { "id": 0, "value": "0.5" },
      "sell_order": { "id": 0, "value": "0.5" },
      "otc_sale": { "id": 0, "value": "0.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
entity	integer	2 (platform sahibi)
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	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.