Toplu kullanıcı silme sonuçlarını listele
GET /v1/jobs/user-deletions/{job_id}/results · izin users:delete
Toplu kullanıcı silme işindeki her kullanıcının sonucunu istek sırasıyla listeler (position 1'den başlar). Her sonuç şunlardan biridir:
pending: kullanıcının sonucu henüz belli değil.succeeded: kullanıcının silmesi başlatıldı;deletion_id, o kullanıcı içinDELETE /v1/users/{user_id}ucunun döndüğü kimliğin aynısıdır.not_found: kullanıcı bu ortamda yoktu ya da zaten silinmişti.failed: silme birkaç denemeden sonra başarısız oldu;error_codeinternal'dır. Kullanıcıyı tek tek ya da yeni bir işle yeniden silin.
Sonuçlar yalnız kullanıcı kimliği taşır; başka kişisel veri dönmez. Liste yalnız ileri sayfalanır: sonraki sayfa için list_metadata.after kullanılır; before ve order desteklenmez.
İstek
| Parametre | Yer | Zorunlu | Açıklama |
|---|---|---|---|
job_id |
path | evet | job_ önekli iş kimliği. |
limit |
query | hayır | Sayfa boyu, 1–100. Varsayılan 20. |
after |
query | hayır | list_metadata.after'dan gelen opak imleç. Yalnız aynı iş için geçerlidir. |
Yanıt
200 OK. list_metadata.after sonraki sayfanın imlecidir (son sayfada null); list_metadata.before her zaman null'dır.
{
"data": [
{
"position": 1,
"user_id": "usr_01h455vb4pex5vsknk084sn02q",
"status": "succeeded",
"deletion_id": "0191f0a0-0000-8000-8000-000000000001"
},
{
"position": 2,
"user_id": "usr_01h455vb4pex5vsknk084sn02r",
"status": "not_found"
}
],
"list_metadata": { "before": null, "after": null }
}
Hatalar
Her hata kararlı bir code taşıyan application/problem+json gövdesidir.
| HTTP | code |
Ne zaman |
|---|---|---|
| 400 | invalid_cursor |
İmleç bozuk, süresi dolmuş ya da başka bir işe ait. |
| 401 | unauthenticated |
API anahtarı yok, geçersiz ya da iptal edilmiş. |
| 403 | insufficient_permissions |
Anahtarda users:delete izni yok. |
| 404 | not_found |
İş bu ortamda yok (ya da kimlik biçimsiz). |
| 422 | validation_failed |
limit aralık dışında, ya da before veya order gönderilmiş (not_supported). |
| 429 | rate_limited |
Hız sınırı aşıldı; Retry-After'a uyun. |
| 503 | service_unavailable |
Bir bağımlılık geçici olarak kullanılamıyor; sonra yeniden deneyin. |
Örnek
curl "https://api.eu.keenauth.com/v1/jobs/user-deletions/job_01h455vb4pex5vsknk084sn02q/results?limit=100" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI: keenauth jobs user-deletions results job_01h455vb4pex5vsknk084sn02q --limit 100