Toplu parola sıfırlama işini getir
GET /v1/jobs/password-resets/{job_id} · izin user-credentials:write
Toplu parola sıfırlama işi oluştur ile oluşturulan işin durumunu ve sayaçlarını döndürür. Kişisel veri dönmez. status şu sırayla ilerler:
marking: seçilen parolalar işaretleniyor;markedartar.waiting: yalnızlazy_then_bulk_reset; işaretleme bitti (marked_at) ve işdeadline_at'i bekliyor.resetting: yalnızlazy_then_bulk_reset; son tarih geçti ve parolasını değiştirmemiş kullanıcıların parolası siliniyor (passwords_deleted), doğrulanmış birincil adresi olanlara sıfırlama e-postası gidiyor (emailed).completed: iş bitti (completed_at).on_loginişi işaretleme biter bitmez tamamlanır.
total, user_ids işinde tekil kullanıcı sayısı, hash_algo işinde 0'dır; not_found, bu ortamın kullanıcısı olmayan ya da parolası olmayan kimlikleri sayar.
İstek
| Parametre | Yer | Zorunlu | Açıklama |
|---|---|---|---|
job_id |
path | evet | job_ önekli iş kimliği. |
Yanıt
200 OK.
{
"id": "job_01h455vb4pex5vsknk084sn02q",
"mode": "on_login",
"filter": "user_ids",
"status": "completed",
"total": 3,
"marked": 2,
"not_found": 1,
"passwords_deleted": 0,
"emailed": 0,
"created_at": "2026-01-15T09:30:00Z",
"marked_at": "2026-01-15T09:31:00Z",
"completed_at": "2026-01-15T09:31:00Z"
}
Hatalar
Her hata, kararlı bir code taşıyan application/problem+json gövdesidir.
| HTTP | code |
Ne zaman |
|---|---|---|
| 401 | unauthenticated |
API anahtarı yok, geçersiz ya da iptal edilmiş. |
| 403 | insufficient_permissions |
Anahtarda user-credentials:write izni yok. |
| 404 | not_found |
İş bu ortamda yok (ya da kimlik biçimsiz). |
| 429 | rate_limited |
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; sonra yeniden deneyin. |
Örnek
curl https://api.eu.keenauth.com/v1/jobs/password-resets/job_01h455vb4pex5vsknk084sn02q \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI: keenauth jobs password-resets get job_01h455vb4pex5vsknk084sn02q