OTC Teklifini İptal Et
Bir token üzerindeki açık bir OTC teklifini iptal eder. Teklif, token içindeki deal ID'siyle adreslenir; düğüm tekliften okunur. Tokenın düğümü API anahtarınızın düğüm alt ağacında olmalı ve teklif açık (status 0) olmalıdır. Çağrı gövde almaz.
Çağrı asenkrondur: tokenın ağında bir iptal işlemi (OTC işlem tipi 2) kaydeder, yayımlar ve ID'sini döner. Teklif ancak bu işlem sonuçlandığında 2 (iptal edildi) olur. İşlem 3 (Done) veya 4 (Error) durumuna gelene kadar OTC İşlemini Al ile sorgulayın.
Gerekli izin: otc:cancel
İstek
POST /v2/admin/otcs/tokens/{token_id}/deals/{deal_id}/cancel
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
token_id | string | path | Zorunlu. Teklifin bulunduğu token (24 karakter hex) |
deal_id | integer | path | Zorunlu. Teklifin zincir üstü deal ID'si, 0'dan büyük |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/admin/otcs/tokens/68ae06cfcccf4e8fc19362d1/deals/2/cancel' \
--header 'Authorization: Bearer <access_token>'
Yanıt
{
"transaction_id": "6a8b5e13f9129816a6cc7a13"
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
transaction_id | string | Bu çağrının başlattığı OTC işlemi. 200, iptalin kuyruğa alındığı anlamına gelir, teklifin iptal edildiği değil |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | Doğrulama başarısız — details alanına bakın. Pozitif tam sayı olmayan bir deal_id dahil |
| 400 | 10016 | token_id 24 karakterlik bir hex ID değil |
| 400 | 11001 (domain 11) | Bu tokenda bu deal ID'siyle teklif yok |
| 400 | 11002 (domain 11) | Teklif açık değil (zaten kabul edilmiş, iptal edilmiş veya reddedilmiş ya da henüz onaylanmamış) |
| 400 | 10001 (domain 5) | Teklifin tokenı bulunamadı |
| 400 | 10001 (domain 2) | Tokenın düğümü bulunamadı |
| 403 | 10005 (domain 2) | Tokenın düğümü, API anahtarınızın düğüm alt ağacının dışında |
| 500 | 10000 | Beklenmeyen sunucu hatası |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.