İ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
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
user_id | string | path | Zorunlu. Satıcının kullanıcı ID'si |
token_id | string | path | Zorunlu. Token ID'si |
deal_id | integer | path | Zorunlu. Kaldırılacak ilanın anlaşma ID'si |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. 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ı
| Alan | Tip | Açıklama |
|---|---|---|
transaction_id | string | İlanı kaldıran kullanıcı işlemi. Kullanıcı İşlemini Getir ile sorgulayın |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | deal_id eksik ya da pozitif bir tam sayı değil — details alanına bakın |
| 400 | 10016 | token_id geçerli 24 karakterlik hex ID değil |
| 400 | 11001 | Domain 11: bu token'da bu kullanıcıya ait böyle bir ilan yok, ilan açık değil ya da cüzdan belirtmiyor |
| 400 | 10001 | Token bulunamadı (domain 5) |
| 500 | 10000 | Beklenmeyen sunucu hatası |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.