Test Hattı Ölçümleri endpoint'i

Test hattı cihazı üreticileri (Mates vb.) için yazma endpoint'i. Cihazın okuduğu fren / süspansiyon / yanal kayma / dinamometre değerleri buraya gönderilir; plaka eşleşmesi sağlanırsa değerler ilgili ekspertiz raporunun Test Hattı Kontrolleri formuna otomatik işlenir.

POST /api/v1/partner/test-line/measurements

Gerekli scope: test-line:write

node scripts/sign.node.mjs POST /api/v1/partner/test-line/measurements "$(cat olcum.json)"

İşleyiş

1. branch_code (bayi kodu, örn. YVZ-SB-01) ölçümün hangi firma + bayiye ait olduğunu belirler. Kod yalnız partner'ın erişim izni olan firmaların bayileri arasında aranır — izin dışı kodlar 404 döner. Bayi kodları devreye alma sırasında ekspertiz.app tarafından paylaşılır (bkz. 09 · Test hattı cihaz entegrasyonu).
2. Ölçüm paketi ham haliyle kaydedilir — veri hiçbir durumda kaybolmaz.
3. Plaka, o bayide açık (yazım aşamasında, son 24 saatte açılmış) bir raporla eşleşirse değerler rapora anında işlenir → status: "applied".
4. Eşleşme yoksa ölçüm havuzda bekler → status: "pending". Eksper aynı plakaya rapor açtığında Test Hattı sayfasında "Cihazdan ölçüm geldi" bandı görünür ve tek tıkla uygulanır. Yani ölçümün rapordan önce gönderilmesi sorun değildir — doğal akış budur.

İstek gövdesi

{
  "branch_code": "YVZ-SB-01",
  "plate": "06 ABC 123",
  "measured_at": "2026-06-10T14:05:00+03:00",
  "external_id": "MATES-OLCUM-90002",
  "device_serial": "MTS-2026-001234",
  "measurements": {
    "DYNO_MEASURED_HP": 118,
    "SUSP_FRONT_LEFT": 78,
    "SUSP_FRONT_RIGHT": 76,
    "SUSP_REAR_LEFT": 71,
    "SUSP_REAR_RIGHT": 74,
    "BRAKE_FRONT_LEFT": 2.4,
    "BRAKE_FRONT_RIGHT": 2.6,
    "BRAKE_REAR_LEFT": 1.4,
    "BRAKE_REAR_RIGHT": 1.5,
    "HANDBRAKE_LEFT": 1.4,
    "HANDBRAKE_RIGHT": 1.5,
    "SLIP_FRONT": -2,
    "SLIP_REAR": 3
  }
}

Ölçüm nokta kodları

Notlar:

• Tüm kodları göndermek zorunda değilsiniz — cihazınız hangi testleri yaptıysa onları gönderin. Eksik kalanları eksper elle tamamlar.
• DYNO_RATIO (güç oranı %) göndermenize gerek yok; DYNO_MEASURED_HP geldiyse ve aracın fabrika gücü sistemde kayıtlıysa oran otomatik hesaplanır.
• Rapor şablonunda karşılığı olmayan kodlar hata üretmez; yanıtta skipped_points içinde unknown_point olarak raporlanır.
• Her değer için durum etiketi (İyi / Sınırda / Limit Dışı) firma bazlı eşik ayarlarına göre sunucu tarafından otomatik atanır — cihazın durum göndermesine gerek yok.

Yanıtlar

201 — yeni ölçüm kabul edildi, rapora otomatik işlendi:

{
  "data": {
    "measurement_id": "cmq7z70o300044whonwmykeap",
    "status": "applied",
    "plate": "61KEJ7501",
    "inspection_id": "cmq7z418f00044wf8bsp8t3i7",
    "applied_points": ["BRAKE_FRONT_LEFT", "BRAKE_FRONT_RIGHT", "..."],
    "idempotent_replay": false
  }
}

201 — yeni ölçüm kabul edildi, açık rapor yok (havuzda bekliyor):

{
  "data": {
    "measurement_id": "cmq7z7srx00074who6kx96q3c",
    "status": "pending",
    "plate": "06ZZD7777",
    "inspection_id": null,
    "applied_points": [],
    "idempotent_replay": false
  }
}

200 — aynı external_id daha önce işlenmişti (idempotent tekrar):

{
  "data": {
    "measurement_id": "cmq7z70o300044whonwmykeap",
    "status": "applied",
    "plate": "61KEJ7501",
    "inspection_id": "cmq7z418f00044wf8bsp8t3i7",
    "idempotent_replay": true
  }
}

Hata kodları

Tüm hata yanıtları standart zarf kullanır:

{ "error": { "code": "not_found", "message": "Resource not found.", "request_id": "req_FX4G57YTBF3F4BEP" } }

request_id'yi loglayın — destek taleplerinde bizimle paylaşın.