# Kullanıcının etkin izinlerini oku

`GET /v1/users/{user_id}/effective-permissions` · izin `users:read`

Kullanıcının etkin izinlerini döndürür (destek ve hata ayıklama): doğrudan ortam rollerinin izinleri ve `org_id` verilirse kullanıcının o org'daki etkin üyeliğinin rollerinin izinleri. Her izin onu veren rolleri listeler. Silinmiş API'lerin izinleri dahil değildir. Liste sayfalanmaz; API'ye, sonra izin değerine göre sıralıdır.

## İstek

| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| `user_id` | path | evet | Kullanıcı kimliği (`usr_…`). |
| `org_id` | query | hayır | Org kimliği (`org_…`); kullanıcının oradaki etkin üyeliğinin rollerini de katar. |
| `api_id` | query | hayır | API kimliği (`api_…`); yalnız o API'nin izinleri. Bilinmeyen API boş liste verir. |

İstek gövdesi yoktur.

## Yanıt

`200 OK`; izinler.

```json
{
  "permissions": [
    {
      "permission_id": "perm_01j9xs0a2b4c6d8e0f2g4h6j8k",
      "api_id": "api_01j9xq1b3c5d7e9f1g3h5j7k9m",
      "value": "read:invoices",
      "role_ids": [
        "rol_01j9xr7s1t2w6x8y0z2a4b6c8e"
      ]
    }
  ]
}
```

## Hatalar

| HTTP | code | Ne zaman |
|---|---|---|
| 404 | `not_found` | Kullanıcı ya da `org_id` ile verilen org bu ortamda yok. |
| 422 | `validation_failed` | `org_id` ya da `api_id` biçimsiz veya tekrarlanmış. |
| 401 | `unauthenticated` | Kimlik bilgisi yok, geçersiz ya da iptal edilmiş. |
| 403 | `insufficient_permissions` | Kimlik bilgisinde gerekli izin yok. |
| 429 | `rate_limited` | Hız sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin. |
| 503 | `service_unavailable` | Bir bağımlılık geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin. |

## Örnek

```bash
curl -i -X GET "https://api.eu.keenauth.com/v1/users/usr_01j9xh2k6p7q1r3s5t7v9w1x3y/effective-permissions?org_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```