Verilerimi dışa aktar
POST /fapi/v1/me/exports · ortamın giriş yap ana makinesinden çağrılır
Oturum açmış kullanıcının kendi verilerinin dışa aktarımını başlatır (GDPR Madde 15 ve 20). Paket arka planda hazırlanır; hazır olduğunda kullanıcı, isteğin dilinde bir e-posta alır ve dosya 7 gün boyunca Bir dışa aktarımı indirin üzerinden indirilebilir.
Paket, veri türü başına bir JSON dosyası içeren bir ZIP dosyasıdır: profil, e-posta adresleri ve telefon numaraları, bağlı kimlikler, kimlik doğrulayıcılar (gizli bilgiler olmadan), IP adresleriyle birlikte oturumlar, kuruluş üyelikleri, OAuth izinleri, onaylar ve giriş olayları. Hiçbir zaman parola karma değerini, TOTP tohumunu, kurtarma kodlarını, belirteçleri veya app_metadata alanını içermez.
Yakın zamanda yapılmış bir giriş gerektirir: oturum son 5 dakikada doğrulanmadıysa veya kullanıcının ikinci bir faktörü varsa ve oturum bunu kullanmadıysa yanıt 401 step_up_required olur ve hiçbir şey başlatılmaz. Kullanıcının hâlâ hazırlanmakta olan bir dışa aktarımı varsa, o dışa aktarım döndürülür ve yeni bir tane başlatılmaz. Bir kullanıcı 24 saat içinde en fazla 2 dışa aktarım isteyebilir.
İstek
Başlıklar:
| Başlık | Zorunlu | Açıklama |
|---|---|---|
Idp-Client |
evet | SDK tanımlayıcısı. |
Origin |
evet | Tam olarak https://<giriş yap ana makinesi> olmalıdır. |
Gövde:
{}
Yanıt
202 Accepted:
{"id": "job_01jbx4k6v8m2c9w5s7r3t1q0zy", "status": "queued", "file": null, "failure_reason": null,
"created_at": "2026-11-03T09:30:00Z", "started_at": null, "completed_at": null, "expires_at": null}
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 401 | unauthenticated |
Geçerli bir oturum çerezi yok. |
| 401 | step_up_required |
Giriş 5 dakikadan eski veya ikinci bir faktör gerekli; WWW-Authenticate başlığı max_age=300 (ve ikinci bir faktör gerektiğinde acr_values) değerini taşır. |
| 403 | origin_not_allowed |
Origin eksik veya yanlış. |
| 429 | export_rate_limited |
Son 24 saat içinde zaten iki dışa aktarım istendi; Retry-After değerinden sonra yeniden deneyin. |
| 429 | rate_limited |
Ortamda çok fazla dışa aktarım hazırlanıyor; Retry-After değerinden sonra yeniden deneyin. |
| 503 | service_unavailable |
Kullanıcı dizini geçici olarak kullanılamıyor; Retry-After değerinden sonra yeniden deneyin. |
Örnek
curl -X POST https://example.keenauth.app/fapi/v1/me/exports \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{}' \
-b cookies.txt
Kişisel veriler
Bu uç nokta kişisel veri içerir: gizlilik talepleri (kullanıcının kendi dışa aktarım kayıtları). 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 kişisel verilerin özel kategorilerini (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.