Para Çekme
Ağın yerel coin'ini ya da bir para birimi token'ını, düğümün (node) saklama cüzdanlarından birinden bir adrese gönderir. Hem cüzdanı (wallet_id) hem ağı (network_id) siz seçersiniz; sunucu bunları sizin yerinize seçmez. Cüzdan düğüme ait olmalı ve ağın zincirinde bulunmalıdır.
Bu çağrı asenkrondur: bir WithdrawType (1) düğüm işlemi kaydeder ve transfer zincire ulaşmadan 200 OK döner. Yanıt gövdesi null'dır — işlemin kimliğini vermez. İşlemi Düğüm İşlemlerini Listele ile types=1 ve kendi wallet_id değerinizle filtreleyerek bulun, ardından status değeri 3 (Done) veya 4 (Error) olana kadar Düğüm İşlemini Al ile yoklayın. Kesinleşen para çekme işlemi Düğüm Ödemelerini Listele listesinde de görünür.
Gerekli izin: wallet:withdraw
İstek
POST /v2/admin/nodes/{node_id}/withdraw
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
node_id | string | path | Zorunlu. Cüzdanın sahibi olan 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 |
|---|---|---|---|
wallet_id | string | Evet | Fonların çıkacağı düğüm cüzdanı (Düğüm Cüzdanlarını Listele) |
network_id | string | Evet | Transferin yapılacağı ağ. Cüzdanın zincirinde olmalıdır |
address | string | Evet | Alıcı adresi (Ethereum biçiminde 0x… adres) |
amount | string | Evet | Gönderilecek tutar; sıfırdan büyük ondalık string. Varlığın ondalık basamak sayısından fazla basamak içeremez. Bkz. Tutarlar ve Yüzdeler |
currency_token_id | string | null | Hayır | Gönderilecek para birimi token'ı. Ağın yerel coin'ini göndermek için göndermeyin ya da null gönderin |
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/admin/nodes/6a4bef2b1e781b11c22e9707/withdraw' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"wallet_id": "6a53f3dfad48accdb46eaf9e",
"network_id": "6740e0a20000000000000101",
"address": "0x1493Ad169f118c260A8597bfe0A72f8262E9f4bA",
"amount": "1.5",
"currency_token_id": null
}'
Yanıt
Gövdesi null olan 200 OK.
null
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | Doğrulama başarısız — eksik wallet_id, network_id veya address, geçersiz adres, sıfır olan ya da fazla ondalık basamak içeren tutar veya var olmayan ağ — details alanına bakın |
| 400 | 10016 | node_id, wallet_id veya network_id geçerli bir kimlik değil |
| 400 | 10001 | Düğüm bulunamadı (düğüm domain'i 2) |
| 400 | 10021 | Cüzdan bu düğüme ait değil ya da ağın zincirinde değil (düğüm domain'i 2) |
| 403 | 10005 | Düğüm, hiyerarşide sizin erişebildiğiniz kısmın dışında (düğüm domain'i 2) |
| 404 | 10001 | Para birimi token'ı bulunamadı (para birimi token domain'i 15) |
| 500 | 10000 | currency_token_id geçerli bir kimlik değil |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.