Ana içeriğe geç

İkincil Piyasadan İlanı Kaldır

Kullanıcının kendi açık ilanlarından birini ikincil piyasadan kaldırır. İlan yoldaki deal_id ile belirtilir (Kullanıcının Token İlanlarını Listele ucundan alın); istek gövdesi yoktur. Kaldırma işlemini ilanda kayıtlı cüzdan imzalar, bu yüzden wallet_id gönderilmez.

Çağrı asenkrondur: bir kullanıcı işlemi (type = 4, ikincil piyasadan ilan kaldırma) kaydeder ve onun transaction_id değerini döndürür. status 3 (tamamlandı) ya da 4 (hata) olana kadar Kullanıcı İşlemini Getir ile sorgulayın; ilan ancak 3 sonrasında kaldırılmış olur.

Yalnızca bu kullanıcının açık bir ilanı kaldırılabilir. Başka bir kullanıcının ilanı, açık olmayan ya da cüzdan belirtmeyen bir ilan bulunamadı olarak yanıtlanır.

Gerekli izin: secondary-market:trade

İstek​

POST /v2/users/{user_id}/secondary-markets/tokens/{token_id}/deals/{deal_id}/delist

Parametreler​

AdTipKonumAçıklama
user_idstringpathZorunlu. Satıcının kullanıcı ID'si
token_idstringpathZorunlu. Token ID'si
deal_idintegerpathZorunlu. Kaldırılacak ilanın anlaşma ID'si

Başlıklar​

AdAçıklama
AuthorizationZorunlu. Bearer <access_token>

Örnek​

curl --request POST \
--url '{{baseUrl}}/v2/users/680c02896d91ca0145cfeb81/secondary-markets/tokens/68ae06cfcccf4e8fc19362d1/deals/12/delist' \
--header 'Authorization: Bearer <access_token>'

Yanıt​

{
"transaction_id": "6913872755654191dede37da"
}

Yanıt Alanları​

AlanTipAçıklama
transaction_idstringİlanı kaldıran kullanıcı işlemi. Kullanıcı İşlemini Getir ile sorgulayın

Hatalar​

DurumKodAçıklama
40010015deal_id eksik ya da pozitif bir tam sayı değil — details alanına bakın
40010016token_id geçerli 24 karakterlik hex ID değil
40011001Domain 11: bu token'da bu kullanıcıya ait böyle bir ilan yok, ilan açık değil ya da cüzdan belirtmiyor
40010001Token bulunamadı (domain 5)
50010000Beklenmeyen sunucu hatası

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.