Bir daveti yeniden gönder
POST /fapi/v1/organizations/{org_id}/invitations/{invitation_id}:resend · ortamın oturum açma sunucusundan çağrılır
Bekleyen bir e-posta davetini yeni bir bağlantıyla yeniden gönderir; önceki bağlantı çalışmayı durdurur. Son kullanma tarihi değişmez. Bir davet en fazla beş kez, en az on dakika arayla gönderilebilir; çok erken yapılan veya sınırı aşan bir gönderim, Retry-After ile birlikte 429 invite_rate_limited döner. Artık bekleyen durumda olmayan veya e-posta teslimi olmadan oluşturulmuş bir davet, 422 invitation_invalid döner. Bağlantının kendisi hiçbir zaman döndürülmez.
Kimliği doğrulanmış kullanıcının tam eşleşen Origin değerine sahip __Host-idp_session çerezi veya birinci taraf bir uygulamanın ön API erişim belirteci (DPoP kanıtıyla birlikte Authorization: DPoP <token>; bkz. Ön API erişim belirteci) gereklidir. Kullanıcı, kuruluşun etkin bir üyesi olmalı ve idp_members:invite iznine sahip olmalıdır. Üye olmayan bir kullanıcı 404 not_found yanıtı alır; izni olmayan bir üye 403 insufficient_permissions yanıtı alır. Ayrıcalıklı bir rol taşıyan bir daveti yalnızca yönetici rolüne sahip bir üye yeniden gönderebilir (403 role_not_assignable).
@keenauth/js ile: await keenauth.organizations.resendInvitation(orgId, invitationId).
İstek
Üstbilgiler:
| Üstbilgi | Zorunlu | Açıklama |
|---|---|---|
Idp-Client |
evet | SDK tanımlayıcısı. |
Origin |
çerezle birlikte evet | https://<oturum açma sunucusu>. |
org_id: kuruluş tanımlayıcısı (org_…). invitation_id: davet tanımlayıcısı (inv_…).
Gövde yoktur.
Yanıt
200 OK ile davet ve ETag: "<version>" döner; send_count ve last_sent_at bu gönderimi yansıtır.
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 401 | unauthenticated |
Geçerli bir oturum çerezi veya belirteci yoktur. |
| 403 | insufficient_permissions |
Kullanıcının kuruluşta idp_members:invite izni yoktur. |
| 403 | role_not_assignable |
Davet ayrıcalıklı bir rol taşıyor ve kullanıcı yönetici rolüne sahip değil. |
| 403 | origin_not_allowed |
Origin eşleşmiyor. |
| 404 | not_found |
Bu kullanıcı için böyle bir kuruluş veya davet yoktur; bilinmeyen, hatalı biçimli veya başka bir kuruluşa ait tanımlayıcılar da aynı yanıtı verir. |
| 409 | organization_disabled |
Kuruluş devre dışı bırakılmış veya silinmeyi bekliyor (organization_pending_deletion). |
| 422 | invitation_invalid |
Davet bekleyen durumda değil veya e-posta teslimi için oluşturulmamış. |
| 429 | invite_rate_limited |
Davet zaten beş kez gönderilmiş veya son gönderimden bu yana on dakika geçmemiş; Retry-After süresinden sonra yeniden deneyin. |
| 501 | not_implemented |
Bu dağıtımda e-posta teslimi kullanılamıyor. |
| 503 | service_unavailable |
Geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin. |
Örnek
curl -X POST "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/invitations/inv_01jbz6x8kq3m2n4p5r6s7t8v9d:resend" \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
{
"id": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d",
"email": "new.member@example.com",
"role_ids": ["rol_01jbz6x8kq3m2n4p5r6s7t8v9w"],
"delivery": "email",
"delivery_status": "queued",
"status": "pending",
"send_count": 2,
"last_sent_at": "2026-11-03T10:30:00Z",
"expires_at": "2026-11-10T10:00:00Z",
"accepted_user_id": null,
"accepted_at": null,
"revoked_at": null,
"created_at": "2026-11-03T10:00:00Z",
"updated_at": "2026-11-03T10:30:00Z",
"version": 2
}
Kişisel veriler
Bu uç nokta kişisel veri içerir: kuruluş üyelikleri ve davetler. KeenAuth API'lerinde kişisel veriler bölümünde neyin saklandığı, ne kadar süreyle tutulduğu ve nasıl silindiği açıklanmaktadır. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.