Token'ı OTC'ye Aç
Bir token'ı tezgâh üstü (OTC) işlemlere açar ya da kapatır. Çağrı asenkrondur: bir OpenToOtc işlemi (tip 12) kuyruğa alır ve id'sini döner. Token'daki is_open_to_otc 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:open-otc
İstek
POST /v2/admin/tokens/{token_id}/open-to-otc
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_open | boolean | Hayır | true token'ı OTC'ye açar, false kapatır. Gönderilmezse false olarak okunur. |
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/admin/tokens/67d8774e903bfcbe7eb5d93e/open-to-otc' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{ "is_open": true }'
Yanıt
{
"transaction_id": "6a8b5e13f9129816a6cc7a12"
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
transaction_id | string | OpenToOtc işlemi. ID ile Token İşlemi Getir ile sorgulayın. |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | Gövde okunamıyor (örneğin is_open 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_open_to_otc 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.