Token Metriğini Güncelle

Bir token'ın listelenen arzını, satın alma sınırlarını, vadesini ve kira koşullarını ayarlar. Her alan gönderildiği gibi uygulanır: gönderilmeyen bir sayı 0, gönderilmeyen term_duration_in_months null olarak okunur ve gönderilmeyen rental_income_currency_token_id kira para birimini temizler; bu yüzden metriğin tamamını her seferinde gönderin.

Değişiklik token'a hemen yazılır. Zincire yalnızca token 6 (Listed) durumundaysa ve total_supply, min_purchase_quantity ya da max_purchase_quantity değiştiyse ulaşır. Bu durumda bir UpdateToken işlemi (tip 5) kuyruğa alınır ve id'si döner; ID ile Token İşlemi Getir ile sorgulayın. Aksi halde yanıt "transaction_id": null taşır ve hemen bir token geçmişi görüntüsü yazılır. Token Güncelle uç noktasında olduğu gibi, yatırımcılar zincir üstü bir değişikliği ancak sonuçlandıktan sonra görür.

Gerekli izin: token:update-metric

İstek

PUT /v2/admin/tokens/{token_id}/metric

Parametreler

Ad	Tip	Konum	Açıklama
token_id	string	path	Zorunlu. Token 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
total_supply	integer	Hayır	Birincil satışa sunulan token'lar (value.listed_supply). Satılmış token'ların altına düşemez ve ücret arzıyla birlikte max_supply'ı aşamaz. Token listelenmişse zincir üstüdür.
min_purchase_quantity	integer	Hayır	Satın alma başına en az token. Token listelenmişse zincir üstüdür.
max_purchase_quantity	integer	Hayır	Satın alma başına en çok token. Token listelenmişse zincir üstüdür.
term_duration_in_months	integer | null	Hayır	Varlığın ay cinsinden vadesi.
rental_income	string	Hayır	Dağıtım başına kira geliri; kira para biriminden fazla ondalık basamak içermeyen ondalık string. rental_income_as_percentage kuralı açık bir kategoride toplam değerin yüzdesidir.
rental_income_currency_token_id	string	Hayır	Kira gelirinin ödendiği para birimi token'ı. Boş ya da gönderilmezse kira para birimi temizlenir.
rental_payment_period_in_days	integer	Hayır	Dağıtımlar arasındaki gün sayısı.
min_tokens_required_for_rental_income	integer	Hayır	Bir sahibin kira geliri alması için gereken en az token.

rental_income, rental_income_currency_token_id, rental_payment_period_in_days ve min_tokens_required_for_rental_income birlikte gider: dördünü de ayarlayın ya da hiçbirini. Token'ın kategorisi ayrıca ödeme periyodunu sabitleyebilir, kira gelirini sınırlayabilir ya da satın alma miktarlarını ve kira için en az token'ı yasaklayabilir (bkz. Hatalar). Tutarlar Tutarlar ve Yüzdeler sayfasındaki kurallara uyar.

Örnek

curl --request PUT \
  --url '{{baseUrl}}/v2/admin/tokens/67d8774e903bfcbe7eb5d93e/metric' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "total_supply": 800,
    "term_duration_in_months": 12,
    "min_purchase_quantity": 1,
    "max_purchase_quantity": 100,
    "min_tokens_required_for_rental_income": 5,
    "rental_income": "250.5",
    "rental_income_currency_token_id": "68fe8c129367fd414b227c7a",
    "rental_payment_period_in_days": 30
  }'

Yanıt

{
  "transaction_id": "6a8b5e13f9129816a6cc7a12"
}

Yanıt Alanları

Alan	Tip	Açıklama
transaction_id	string | null	Değişiklik zincire ulaştığında UpdateToken işlemi; yalnızca zincir dışı uygulandıysa null.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın. Ayrıca hatalı biçimli ya da para biriminden fazla ondalık basamaklı bir rental_income için döner
400	10016	token_id ya da rental_income_currency_token_id geçerli bir id değil
400	10001	Token bulunamadı (token domain'i 5)
403	10005	Çağıranın düğümü token'ın düğümünü kapsamıyor (düğüm domain'i 2)
400	10022	Dört kira alanı birlikte ayarlanmadı ya da birlikte boş bırakılmadı (token domain'i 5)
400	10002	total_supply ile ücret arzının toplamı max_supply'ı aşıyor (token domain'i 5)
400	52003	total_supply satılmış token'ların altında (domain 52)
404	10001	Kira para birimi token'ı bulunamadı (para birimi token'ı domain'i 15)
400	10017	Kategori rental_income değerini 1 ile 100 arasıyla sınırlıyor (token domain'i 5)
400	10018	rental_payment_period_in_days kategorinin periyoduna eşit olmalı (token domain'i 5)
400	10019	Kategori min_purchase_quantity değerinin 0 olmasını gerektiriyor (token domain'i 5)
400	10020	Kategori max_purchase_quantity değerinin 0 olmasını gerektiriyor (token domain'i 5)
400	10021	Kategori min_tokens_required_for_rental_income değerinin 0 olmasını gerektiriyor (token domain'i 5)

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