# Bir kullanıcının verilerini dışa aktar

`POST /v1/users/{user_id}:export` · izin `users:export`

Bir kullanıcı hakkında KeenAuth'ta tutulan kişisel verileri, bir veri konusu erişim veya taşınabilirlik talebi için (GDPR 15. ve 20. maddeler) paketleyen bir iş başlatır. İş arka planda çalışır: `status` değeri `completed` olana kadar [Bir kullanıcı veri dışa aktarma işini al](/docs/api/management/jobs/get-user-export) uç noktasını sorgulayın, ardından [paketi indirin](/docs/api/management/jobs/download-user-export). Son kullanıcıya e-posta gönderilmez; paketi ona iletmek sizin sorumluluğunuzdadır.

## İstek

| Parametre | Konum | Zorunlu | Açıklama |
|---|---|---|---|
| `user_id` | path | evet | Kullanıcı kimliği, `usr_` öneki ile. |
| `Idempotency-Key` | header | hayır | 16–64 karakter `[A-Za-z0-9_-]`. Aynı kimlik bilgisinden gelen aynı anahtar aynı işi döndürür. |
| `include_ip` | body | hayır | `true` ise oturum ve olay IP adreslerini pakete ekler. Ayrıca `audit-events:read_ip` izni gerektirir. Varsayılan `false`. |

Gövde isteğe bağlıdır; IP adresleri olmadan dışa aktarma için `{}` gönderin veya gövde göndermeyin.

```json
{ "include_ip": false }
```

## Yanıt

`202 Accepted` ile iş döner. Aynı `Idempotency-Key` ile tekrarlanan istek, özgün işi ve `Idempotent-Replayed: true` başlığını döndürür.

```json
{
  "id": "job_01j9xk3m7q8r2s4t6v8w0y2z4e",
  "kind": "subject",
  "source": "management_api",
  "user_id": "usr_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "status": "queued",
  "include_app_metadata": true,
  "include_ip": false,
  "file": null,
  "failure_reason": null,
  "requested_by": { "type": "api_key", "id": "key_01j9xk3m7q8r2s4t6v8w0y2z4b" },
  "created_at": "2026-10-28T09:00:00Z",
  "started_at": null,
  "completed_at": null,
  "expires_at": null
}
```

Paket bir ZIP dosyasıdır:

| Dosya | İçerik |
|---|---|
| `manifest.json` | Şema sürümü, iş ve kullanıcı kimlikleri, oluşturulma zamanı, kaynak ve diğer her dosyanın SHA-256 değeri ile kayıt sayısı. |
| `profile.json`, `emails.json`, `phones.json` | Profil alanları, e-posta adresleri ve telefon numaraları. |
| `metadata.json` | `user_metadata` ve `app_metadata`. |
| `identities.json` | Bağlı sosyal ve kurumsal kimlikler. |
| `authenticators.json`, `sessions.json` | Passkey'ler ve diğer kimlik doğrulayıcılar (sırlar hariç) ile oturumlar. |
| `organizations.json`, `oauth_grants.json`, `consents.json` | Kuruluş üyelikleri, OAuth yetkilendirmeleri ve onay kayıtları. |
| `auth_events.ndjson` | Kimlik doğrulama olayları, satır başına bir JSON nesnesi. |

Parola karmaları, TOTP tohumları, kurtarma kodları, oturum belirteçleri ve ham SAML veya ID belirteçleri hiçbir zaman dahil edilmez. Paket, iş tamamlandıktan sonra 7 gün saklanır.

## Hatalar

Her hata, kararlı bir `code` içeren bir `application/problem+json` gövdesidir.

| HTTP | `code` | Ne zaman |
|---|---|---|
| 400 | `malformed_request` | Gövde veya `Idempotency-Key` başlığı hatalı biçimlendirilmiş. |
| 401 | `unauthenticated` | API anahtarı eksik, geçersiz veya iptal edilmiş. |
| 403 | `insufficient_permissions` | Anahtarda `users:export` izni yok veya `include_ip` `true` ve anahtarda `audit-events:read_ip` izni yok (`required_permissions` ikisini de listeler). |
| 404 | `not_found` | Kullanıcı bu ortamda mevcut değil veya kimlik biçimi hatalı. |
| 422 | `idempotency_key_reuse` | `Idempotency-Key` farklı bir istekle kullanılmış. |
| 429 | `rate_limited` | Bu ortamda çok fazla dışa aktarma işi kuyrukta veya çalışır durumda ya da hız sınırı aşıldı; `Retry-After` değerine uyun. |
| 503 | `service_unavailable` | Bir bağımlılık geçici olarak kullanılamıyor; daha sonra yeniden deneyin. |

## Örnek

```bash
curl -X POST https://api.eu.keenauth.com/v1/users/usr_01j9xk3m7q8r2s4t6v8w0y2z4a:export \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: dsar-2026-10-28-0001" \
  -H "Content-Type: application/json" \
  -d '{"include_ip": false}'
```

CLI: `keenauth users export usr_01j9xk3m7q8r2s4t6v8w0y2z4a`

## Kişisel veriler

Bu uç nokta kişisel veri içerir: son kullanıcı profili. [KeenAuth API'lerinde kişisel veriler](/docs/policies/personal-data) neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.