İkincil Piyasa Grup Arama

Belirli bir kullanıcıyla ilişkili ikincil piyasa gruplarını arayın.

Endpoint

POST /v2/users/secondary-markets/users/{user_id}/group-search

Headers

Header	Değer
Content-Type	application/json
Authorization	Bearer {token}

Yol Parametreleri

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

İstek Gövdesi

{
    "page": 1,
    "per_page": 10
}

Parametreler

Parametre	Tip	Gerekli	Açıklama
page	integer	Evet	Sayfalama için sayfa numarası
per_page	integer	Evet	Sayfa başına öğe sayısı

Yanıt

Kullanıcıyla ilişkili ikincil piyasa gruplarının sayfalı listesini döndürür.

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

{
    "data": [
        {
            "id": "string",
            "token_id": "string",
            "token_name": "string",
            "token_symbol": "string",
            "deal_id": "number",
            "quantity": "number",
            "price": {
                "amount": "number",
                "decimal": "number",
                "symbol": "string"
            },
            "seller_id": "string",
            "seller_name": "string",
            "status": "string",
            "created_at": "string",
            "updated_at": "string"
        }
    ],
    "pagination": {
        "current_page": 1,
        "per_page": 10,
        "total": "number",
        "total_pages": "number"
    }
}

Örnek

İstek

curl -X POST "\{\{baseUrl\}\}/v2/users/secondary-markets/users/680c02896d91ca0145cfeb81/group-search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer \{\{token\}\}" \
  -d '{
    "page": 1,
    "per_page": 10
  }'

Yanıt

{
    "data": [
        {
            "id": "deal_123",
            "token_id": "68ae06cfcccf4e8fc19362d1",
            "token_name": "Gayrimenkul Token",
            "token_symbol": "RET",
            "deal_id": 13,
            "quantity": 50,
            "price": {
                "amount": 12.5,
                "decimal": 6,
                "symbol": "USDT"
            },
            "seller_id": "680c02896d91ca0145cfeb82",
            "seller_name": "Ahmet Yılmaz",
            "status": "active",
            "created_at": "2024-01-15T10:30:00Z",
            "updated_at": "2024-01-15T10:30:00Z"
        }
    ],
    "pagination": {
        "current_page": 1,
        "per_page": 10,
        "total": 1,
        "total_pages": 1
    }
}

Hata Yanıtları

400 Bad Request

{
    "error": "Geçersiz istek parametreleri"
}

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ı"
}