Ticaretleri Ara
Bu endpoint, sayfalama desteği ile ticaretleri aramanıza ve listelemeye olanak tanır.
Endpoint
GET /api/v1/trades
Başlıklar
| İsim | Tip | Açıklama |
|---|---|---|
| Authorization | string | Kimlik doğrulama için Bearer token |
| X-Target-Server | string | Hedef sunucu tanımlayıcısı (örn. "declaration") |
Query Parametreleri
| İsim | Tip | Açıklama |
|---|---|---|
| page | integer | Sayfalama için sayfa numarası (varsayılan: 1) |
| per_page | integer | Sayfa başına öğe sayısı (varsayılan: 10) |
Yanıt
Başarılı Yanıt (200 OK)
{
"data": [
{
"id": "string",
"name": "string",
"node_name": "string",
"node_id": "string",
"status": "integer",
"type": "integer",
"permissions": [
{
"node_id": "string",
"created_at": "string"
}
],
"created_by": "string",
"created_at": "string",
"updated_at": "string"
}
],
"total": "integer",
"page": "integer",
"per_page": "integer"
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
| data | array | Ticaret nesnelerinin dizisi |
| data[].id | string | Ticaretin benzersiz tanımlayıcısı |
| data[].name | string | Ticaretin adı |
| data[].node_name | string | Düğümün adı |
| data[].node_id | string | Düğümün ID'si |
| data[].status | integer | Ticaretin durumu |
| data[].type | integer | Ticaretin türü |
| data[].permissions | array | İzin nesnelerinin dizisi |
| data[].permissions[].node_id | string | İzni olan düğümün ID'si |
| data[].permissions[].created_at | string | İznin oluşturulma zaman damgası |
| data[].created_by | string | Ticareti oluşturan kullanıcının ID'si |
| data[].created_at | string | Ticaretin oluşturulma zaman damgası |
| data[].updated_at | string | Ticaretin son güncelleme zaman damgası |
| total | integer | Toplam ticaret sayısı |
| page | integer | Mevcut sayfa numarası |
| per_page | integer | Sayfa başına öğe sayısı |
Örnek İstek
curl --request GET \
--url '{{HOST}}/api/v1/trades?page=1&per_page=10' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'X-Target-Server: declaration'
Örnek Yanıt
{
"data": [
{
"id": "68247532b5e19b4fafa3f894",
"name": "API Trade",
"node_name": "Interzoon A.S",
"node_id": "6784fea5481a2963fcb2d74c",
"status": 1,
"type": 1,
"permissions": [],
"created_by": "6784fea5481a2963fcb2d74d",
"created_at": "2025-05-14T10:49:22.835Z",
"updated_at": "2025-05-14T10:49:22.835Z"
}
],
"total": 19,
"page": 1,
"per_page": 10
}