ID ile Para Birimi Tokenı Gönder
Bir para birimi tokenından belirli bir miktarı bir alıcı adrese gönderir. Token 3 (Active) durumunda olmalıdır. Transfer, oluşturma anında tokena sabitlenen cüzdanla, tokenın ağında imzalanır. Tokenın düğümü platformun kök düğümü olmalı ve API anahtarınızın düğüm alt ağacında bulunmalıdır.
amount, en fazla tokenın decimals değeri kadar ondalık içeren bir ondalık string'dir (bu API ile oluşturulan tokenlarda 6): "250.5" kabul edilir, "0.1234567" reddedilir, asla yuvarlanmaz. Bkz. Tutarlar ve Yüzdeler.
Çağrı asenkrondur: bir SendCurrencyToken (tip 3) işlemi kaydeder, yayımlar ve ID'sini döner. İşlem 3 (Done) veya 4 (Error) durumuna gelene kadar ID ile Para Birimi Tokenı İşlemlerini Al ile sorgulayın.
Gerekli izin: currency-token:send
İstek
POST /v2/admin/currency-tokens/{currency_token_id}/send
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
currency_token_id | string | path | Zorunlu. Para birimi token ID'si (24 karakter hex) |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Content-Type | Zorunlu. application/json |
Gövde
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
amount | string | Evet | Gönderilecek miktar; sıfırdan büyük, en fazla tokenın decimals değeri kadar ondalıklı |
recipient_wallet | string | Evet | Alıcı cüzdan adresi |
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/admin/currency-tokens/6a859ae35a7db4268dfb40d2/send' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"amount": "250.5",
"recipient_wallet": "0x3b4E4dd67EE4054514bA2101e981f4C4D44eFDDc"
}'
Yanıt
{
"transaction_id": "6a8b5e13f9129816a6cc7a13"
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
transaction_id | string | Bu çağrının başlattığı para birimi token işlemi. 200, gönderimin kuyruğa alındığı anlamına gelir, tamamlandığı değil |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | Doğrulama başarısız — details alanına bakın. Eksik recipient_wallet ve eksik, sıfır, hatalı biçimli veya fazla hassas amount dahil |
| 404 | 10001 (domain 15) | Para birimi tokenı bulunamadı |
| 400 | 10005 (domain 15) | Token Active değil: dağıtımı onaylanmadı |
| 400 | 10001 (domain 2) | Tokenın düğümü bulunamadı |
| 403 | 10005 (domain 2) | Tokenın düğümü platformun kök düğümü değil ya da API anahtarınızın düğüm alt ağacının dışında |
| 500 | 10000 | Beklenmeyen sunucu hatası; 24 karakterlik hex olmayan bir currency_token_id dahil |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.