Davetleri listeleyin

GET /v1/invitations · izin invitations:read

Ortamın davetlerini en eskiden en yeniye doğru listeler. Yalnızca ileri sayfalama desteklenir. Filtreler: organization_id, email (tam eşleşme) ve status. İmleç filtrelere bağlıdır; e-posta imlece yalnızca anahtarlı bir karma olarak girer. Kabul bağlantıları hiçbir zaman listelenmez.

İstek

Alan Tür Zorunlu Açıklama
limit query hayır 1–100, varsayılan 20.
after query hayır list_metadata.after değerinden alınan imleç.
organization_id query hayır Kuruluş kimliği (org_…).
email query hayır E-posta adresi (tam eşleşme).
status query hayır pending, accepted, revoked veya expired.

İstek gövdesi yoktur.

Yanıt

Davetlerden oluşan bir sayfayla birlikte 200 OK.

{
  "data": [
    {
      "id": "inv_01j9xt9v3w4y8z0a2b4c6d8e0g",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "email": "ada@example.com",
      "role_ids": [
        "rol_01j9xr7s1t2w6x8y0z2a4b6c8e"
      ],
      "application_id": null,
      "delivery": "link_only",
      "delivery_status": "not_sent",
      "status": "pending",
      "send_count": 1,
      "last_sent_at": "2026-10-12T09:31:00.123456Z",
      "expires_at": "2026-10-19T09:31:00.123456Z",
      "accepted_user_id": null,
      "accepted_at": null,
      "revoked_at": null,
      "created_at": "2026-10-12T09:31:00.123456Z",
      "updated_at": "2026-10-12T09:31:00.123456Z",
      "version": 1
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Hatalar

HTTP kod Ne zaman
400 invalid_cursor İmleç geçersiz veya başka filtrelere ait.
422 validation_failed Bir filtre veya limit geçersiz; ya da before veya asc dışında bir order verildi.
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinde gerekli izin yok.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

curl -i "https://api.eu.keenauth.com/v1/invitations?organization_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a&status=pending" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Kişisel veriler

Bu uç nokta kişisel veri içerir: kuruluş üyelikleri ve davetler. 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.