DEVekspertiz.app

Organizations & Branches endpoint'leri

GET /api/v1/partner/health

Auth + bağlantı testi. DB sorgusu yok, hızlı.

Yanıt:

{
  "status": "ok",
  "partner": "trameks",
  "environment": "live",
  "server_time": "2026-05-17T14:30:00Z"
}

GET /api/v1/partner/organizations

Bu API key'in erişebileceği tüm Organization'lar.

Yanıt:

{
  "data": [
    {
      "id": "org_cl4ab...",
      "slug": "yavuz-ekspertiz",
      "name": "Yavuz Oto Ekspertiz",
      "branch_count": 12,
      "pii_mode": "NONE"
    }
  ]
}

branch_count: bu partner'a açık olan bayilerin sayısı (kısıtlı alt-küme varsa o kadar). pii_mode: bu org'daki rapor PII alanlarının nasıl döneceği (NONE / MASKED / FULL). Detay: 05 · PII maskeleme.


GET /api/v1/partner/organizations/{orgId}/branches

Bir org'un partner'a açık bayilerini listeler.

Query parametreleri:

ParamTipAçıklama
citystringŞehir filtresi (exact)
activebooleanDefault true. false = pasif bayiler

Yanıt:

{
  "data": [
    {
      "id": "br_clxy...",
      "code": "YAV-ANK-01",
      "name": "Çankaya Şubesi",
      "city": "Ankara",
      "district": "Çankaya",
      "is_active": true
    }
  ]
}

Erişim yoksa 404 not_found (org var ama bu partner'a açık değil — ID enumeration koruması).