Skip to main content
/me endpoint’i; aktif kullanıcının kim olduğu, hangi tenant’a bağlı, hangi merchant adına çalıştığı ve hangi modüller için yetkili olduğunu tek bir istekte döner. Konsolun ilk açılışta yaptığı kanonik çağrıdır.

​
Endpoint

GET /api/v1/me
Bearer access token gerektirir.

​
İstek

curl https://identity.payven.com.tr/api/v1/me \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiI..."

​
Yanıt

200 OK — MeDto: 
{
  "user": {
    "id":       "9f3d2b8e-...",
    "username": "ayse@example.com",
    "email":    "ayse@example.com",
    "name":     "Ayşe Yılmaz"
  },
  "tenant": {
    "id":            "1a2b3c4d-...",
    "slug":          "payven",
    "display_name":  "Payven A.Ş."
  },
  "merchant": {
    "id":          "3fa85f64-...",
    "external_id": "M-IST-001",
    "name":        "Acme E-Ticaret"
  },
  "roles": ["pos-admin", "transfer-viewer"],
  "features": [
    {
      "code":         "sanalpos",
      "display_name": "Sanal POS",
      "base_path":    "/sanalpos",
      "is_active":    true,
      "permissions": [
        "transactions.view",
        "transactions.refund",
        "merchants.manage"
      ],
      "nav_items": [
        { "id": "dashboard",    "name": "Genel Bakış", "href": "/dashboard" },
        { "id": "transactions", "name": "İşlemler",     "href": "/transactions" },
        { "id": "refunds",      "name": "İadeler",      "href": "/refunds" }
      ]
    },
    {
      "code":         "para-transferi",
      "display_name": "Para Transferi",
      "base_path":    "/paratransferi",
      "is_active":    true,
      "permissions":  ["transfers.view"],
      "nav_items":    [...]
    }
  ]
}
AlanAçıklama
userKullanıcı kimliği — id, username, email, name
tenantAktif tenant — id, slug, display_name (null olabilir, access token claim’inde yoksa)
merchantAktif merchant — multi-merchant senaryolarda override edilebilir (null olabilir)
rolesTenant rolleri (pos-admin, transfer-admin, tenant-admin, vb.)
features[]Tenant planında aktif modül feature’ları — her birinin kullanıcının rollerinden çıkarılan effective permission listesi + filtrelenmiş nav item’lar

​
Plan ve kullanım

Tenant planının detayını ayrı endpoint’ten çekin: 
GET /api/v1/me/plan
Yanıt — MyPlanDto: 
{
  "plan": {
    "id":                "abc-...",
    "code":              "standard",
    "name":              "Standart Plan",
    "description":       "...",
    "price":             999900,
    "currency":          "TRY",
    "billing_cycle":     "monthly",
    "features": [
      { "code": "sanalpos",       "name": "Sanal POS",       "category": "module" },
      { "code": "para-transferi", "name": "Para Transferi",  "category": "module" }
    ]
  }
}
Tenant planı yoksa yanıt null döner.

​
Kullanım örnekleri

​
Aktif modülleri keşfet

const me = await fetch("/api/v1/me", { headers: auth }).then(r => r.json());
const activeModules = me.features.filter(f => f.is_active).map(f => f.code);
// → ["sanalpos", "para-transferi"]

​
UI’da bir butonu permission ile koru

const sanalpos = me.features.find(f => f.code === "sanalpos");
const canRefund = sanalpos?.permissions.includes("transactions.refund");

if (!canRefund) hideRefundButton();

const navItems = sanalpos?.nav_items ?? [];
// Backend filtered: kullanıcının izni olmayanlar zaten listede yok

​
Hata response’ları

HTTPAnlam
401Token yok / geçersiz / expired
404(boş) Kullanıcı tenant context’i bulunamadı

​
Alternatif endpoint

/api/v1/auth/{slug}/me endpoint’i userinfo proxy olarak da kullanılabilir — sadece ham userinfo döner (roles + email + name), tenant/merchant/feature context’i içermez. Production akışlarında /api/v1/me tercih edin.