Ana içeriğe geç

GET /store/{store-code}/terminal/{terminal-code} — Terminal Detayı Sorgulama

📋 Genel Bilgi

Belirli bir mağazadaki belirli bir terminalin detaylı bilgilerini sorgular.

Base URL: {{url}}/store/{{store_code}}/terminal/{{terminal_code}} Method: GET Content-Type: application/json


🔐 Headers

HeaderValue
AuthorizationBearer {{masked_jwt_5}}

📥 URL Parametreleri

ParametreTipAçıklamaÖrnek
store-codestringMağaza kodu (path param)"mobildev-mq"
terminal-codestringTerminal kodu (path param)"TERM-001"

✅ Response — 200 OK

{
"name": "Terminal 1 Updated",
"code": "TERM-001",
"status": "active",
"terminalKey": "t5ufKwlji",
"lastAuthAt": 0,
"weeklyAuthData": {
"previousWeek": 0,
"currentWeek": 3,
"dailyData": [2, 1]
},
"createdAt": 1783515976,
"updatedAt": 1783932455
}

Response Alanları

AlanTipAçıklama
namestringTerminal adı
codestringTerminal kodu
statusstringDurum (active, inactive)
terminalKeystringTerminal benzersiz anahtarı
lastAuthAtintegerSon doğrulama zamanı (Unix timestamp)
weeklyAuthData.previousWeekintegerGeçen hafta doğrulama sayısı
weeklyAuthData.currentWeekintegerBu hafta doğrulama sayısı
weeklyAuthData.dailyData[]arrayGünlük doğrulama verileri
createdAtintegerOluşturma zamanı (Unix timestamp)
updatedAtintegerGüncelleme zamanı (Unix timestamp)

❌ Error Responses

Tüm hata yanıtları aşağıdaki formatta döner:

{
"Response": {
"code": 3008,
"description": "Invalid terminal ID"
},
"Success": false
}
HTTPcodeEnumdescriptionNe Zaman Oluşur
4043006StoreTerminalIdInvalidInvalid terminal IDstoreId + terminal-code kombinasyonuna karşılık gelen bir terminal kaydı bulunamadı

Örnek — 404 Terminal Not Found

{
"Response": {
"code": 3006,
"description": "Invalid terminal ID"
},
"Success": false
}

📝 Notlar

  • Terminal bulunamadığında yukarıdaki hata (3008, HTTP 404) döner.
  • Performans metrikleri gerçek zamanlı hesaplanır.
  • Hata response'larındaki code alanı AppError enum'undaki uygulama-içi hata kodudur (Response.code); tüm hata gövdesi Response adlı bir alt obje içinde döner, en dışta ayrıca Success: false alanı bulunur.