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 uç noktasını sorgulayın, ardından paketi indirin. 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.

{ "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.

{
  "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

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 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.