Token Genel Transferi
Token'ın sahipler arasında serbestçe transfer edilmesine izin verir ya da bunu kısıtlar. Çağrı asenkrondur: bir PublicTransferToken işlemi (tip 8) kuyruğa alır ve id'sini döner. Token'daki is_public alanı yalnızca işlem 3 (Done) olduğunda değişir; ID ile Token İşlemi Getir ile sorgulayın.
Token'ın zaten taşıdığı değeri isteyen bir istek reddedilir (10027); bu bayraktaki önceki bir değişiklik hâlâ sürerken gelen bir istek de reddedilir (10028). Bayrak ikisini tek başına ayırt edemez, çünkü ancak bir değişiklik sonuçlandığında hareket eder.
Gerekli izin: token:public-transfer
İstek
POST /v2/admin/tokens/{token_id}/public-transfer
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 |
|---|---|---|---|
is_public | boolean | Hayır | true sahiplerin token'ı serbestçe transfer etmesine izin verir, false transferleri kısıtlar. Gönderilmezse false olarak okunur. |
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/admin/tokens/67d8774e903bfcbe7eb5d93e/public-transfer' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{ "is_public": true }'
Yanıt
{
"transaction_id": "6a8b5e13f9129816a6cc7a12"
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
transaction_id | string | PublicTransferToken işlemi. ID ile Token İşlemi Getir ile sorgulayın. |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | Gövde okunamıyor (örneğin is_public boolean değil) |
| 400 | 10016 | 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) |
| 409 | 10027 | is_public istenen değeri zaten taşıyor; hiçbir şey olmayacak (token domain'i 5) |
| 409 | 10028 | Bu bayrakta süren bir değişiklik var; işleminin sonuçlanmasını bekleyin (token domain'i 5) |
Kabulden sonraki bir başarısızlık işlemi 4 (Error) durumunda bitirir; nedeni error alanındadır. Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.