Kullanıcı İşlemlerini Al

Belirli bir kullanıcı için filtreleme seçenekleriyle işlemleri alın.

Endpoint

GET /v2/users/users/{user_id}/transactions

Headers

Header	Değer
Authorization	Bearer {token}

Yol Parametreleri

Parametre	Tip	Gerekli	Açıklama
user_id	string	Evet	Kullanıcının benzersiz tanımlayıcısı

Sorgu Parametreleri

Parametre	Tip	Gerekli	Açıklama
page	integer	Evet	Sayfalama için sayfa numarası
per_page	integer	Evet	Sayfa başına öğe sayısı
types	integer[]	Hayır	İşlem tiplerine göre filtrele (birden fazla olabilir)

Yanıt

Belirtilen kullanıcı için sayfalı işlem listesini döndürür.

Başarılı Yanıt (200 OK)

{
    "data": [
        {
            "id": "68da490b2690ac9ed917101d",
            "user_id": "680c02896d91ca0145cfeb81",
            "type": 2,
            "status": 1,
            "environment": 2,
            "external_id": "68ae06cfcccf4e8fc19362d1",
            "is_api": false,
            "created_at": "0001-01-01T00:00:00Z",
            "updated_at": "0001-01-01T00:00:00Z"
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 10
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	İşlem nesnelerinin dizisi
total	integer	Toplam işlem sayısı
page	integer	Mevcut sayfa numarası
per_page	integer	Sayfa başına öğe sayısı

İşlem Nesnesi Yapısı

Alan	Tip	Açıklama
id	string	Benzersiz işlem tanımlayıcısı
user_id	string	Kullanıcı tanımlayıcısı
type	integer	İşlem tipi (Type enum)
status	integer	İşlem durumu (Status enum)
environment	integer	İşlem ortamı (Environment enum)
external_id	string	Harici referans tanımlayıcısı
is_api	boolean	İşlemin API ile oluşturulup oluşturulmadığı
created_at	string	Oluşturulma zamanı (ISO 8601)
updated_at	string	Son güncelleme zamanı (ISO 8601)

Type (İşlem Tipi)

Değer	Açıklama
1	PurchaseOnPrimaryMarket - Birincil piyasa satın alma
2	PurchaseOnSecondaryMarket - İkincil piyasa satın alma
3	SellOnSecondaryMarket - İkincil piyasa satış
4	DelistOnSecondaryMarket - İkincil piyasa listesinden çıkarma
5	ClaimRent - Kira talep etme
6	CreateOtcOffer - OTC teklifi oluşturma
7	CancelOtcOffer - OTC teklifini iptal etme
8	Burn - Token yakma

Status (İşlem Durumu)

Değer	Açıklama
1	Started - İşlem başladı
2	InProgress - İşlem devam ediyor
3	Done - İşlem tamamlandı
4	Error - İşlem başarısız

Environment (İşlem Ortamı)

Değer	Açıklama
0	DefaultEnvironment - Varsayılan ortam
1	OtcEnvironment - OTC ortamı
2	SecondaryMarketEnvironment - İkincil piyasa ortamı

Örnek

İstek

curl -X GET "{{baseUrl}}/v2/users/users/680c02896d91ca0145cfeb81/transactions?page=1&per_page=10&types=1&types=2" \
  -H "Authorization: Bearer \{\{token\}\}"

Yanıt

{
    "data": [
        {
            "id": "68da490b2690ac9ed917101d",
            "user_id": "680c02896d91ca0145cfeb81",
            "type": 2,
            "status": 1,
            "environment": 2,
            "external_id": "68ae06cfcccf4e8fc19362d1",
            "is_api": false,
            "created_at": "0001-01-01T00:00:00Z",
            "updated_at": "0001-01-01T00:00:00Z"
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 10
}

Hata Yanıtları

400 Bad Request

{
    "error": "Geçersiz kullanıcı ID formatı"
}

401 Unauthorized

{
    "error": "Kimlik doğrulaması gerekli"
}

403 Forbidden

{
    "error": "Erişim reddedildi"
}

404 Not Found

{
    "error": "Kullanıcı bulunamadı"
}

500 Internal Server Error

{
    "error": "İç sunucu hatası"
}