Token Yak
Kullanıcının bir cüzdandaki bir token varlığını yakar ve karşılığını token'ın ödeme para biriminde öder. wallet_id zorunludur: varlıklar cüzdan bazındadır ve belirtilen cüzdan hem yakılan pozisyonu tutar hem de zincir üstü çağrıyı imzalar (gas'ını öder). Cüzdan bu kullanıcıya ait olmalı ve token'ın zincirinde bulunmalıdır. Çağrı miktar almaz: cüzdanın bu token'daki varlığı yakılır. Zincirde yakma işlemi bir asgari ödeme taşır: havuz fiyatı değişir ve yakma madenlenmeden önce ödeme bu tabanın altına düşerse zincir işlemi geri alır ve işlem daha az ödemek yerine hata ile biter.
Yakma asenkrondur. Bir kullanıcı işlemi (type = 8, yakma) kaydeder ve boş gövdeli 200 döndürür: işlem ID'si dönmez. Takip etmek için kullanıcının işlemlerini Kullanıcı İşlemlerini Getir ile types=8 filtresiyle listeleyin ve en yenisinin status değerinin 3 (tamamlandı, zincir hash'i ile) ya da 4 (hata) olmasını bekleyin.
Gerekli izin: token:burn
İstek
POST /v2/users/{user_id}/tokens/{token_id}/burn
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
user_id | string | path | Zorunlu. Kullanıcı ID'si |
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 |
|---|---|---|---|
wallet_id | string | Evet | Varlığı yakılan ve yakmayı imzalayan cüzdan (wallets._id). Kullanıcıya ait olmalı ve token'ın zincirinde bulunmalıdır |
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/users/680c02896d91ca0145cfeb81/tokens/68ae06cfcccf4e8fc19362d1/burn' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"wallet_id": "6a89b68e0c46ca4c941271aa"
}'
Yanıt
Boş gövdeli 200 OK.
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | Doğrulama başarısız (wallet_id) — details alanına bakın |
| 400 | 10016 | token_id ya da wallet_id geçerli 24 karakterlik hex ID değil |
| 400 | 10001 | Token bulunamadı (domain 5) |
| 400 | 10015 | Domain 1: wallet does not belong to this user on this network — cüzdan yok, bu kullanıcıya ait değil ya da başka bir zincirde |
| 500 | 10000 | Beklenmeyen sunucu hatası |
Yakma kabul edildikten sonraki bir hata (örneğin gas için yerel bakiyesi olmayan bir cüzdan ya da tabanın altında kalan bir ödeme) HTTP hatasına dönüşmez: işlem status = 4 ile biter ve nedeni error alanındadır.
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.