Yönetici Portalı bağlantılarını listele
GET /v1/admin-portal-links · izin admin-portal-links:read
Ortamın Yönetici Portalı bağlantılarını yeniden eskiye listeler; organization_id listeyi tek org'a daraltır. Yalnız ileri sayfalama vardır. İmleç süzgece bağlıdır. Bağlantı URL'leri hiçbir zaman listelenmez. consumed_at bağlantı portal oturumunu açınca, revoked_at iptal edilince dolar.
İstek
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
limit |
query | hayır | 1–100, varsayılan 20. |
after |
query | hayır | list_metadata.after imleci. |
organization_id |
query | hayır | Org kimliği (org_…). |
İstek gövdesi yoktur.
Yanıt
Bir sayfa bağlantıyla 200 OK.
{
"data": [
{
"id": "apl_01j9xv2c4d6e8f0g2h4j6k8m0n",
"organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
"intents": [
"dsync",
"sso"
],
"delivery": "link",
"return_url": "https://app.example.com/settings/sso",
"expires_at": "2026-10-12T09:36:00.123456Z",
"consumed_at": null,
"revoked_at": null,
"created_at": "2026-10-12T09:31:00.123456Z"
}
],
"list_metadata": {
"before": null,
"after": null
}
}
Hatalar
| HTTP | code | Ne zaman |
|---|---|---|
| 400 | invalid_cursor |
İmleç geçersiz ya da başka bir süzgece ait. |
| 422 | validation_failed |
organization_id ya da limit geçersiz veya before ya da order verilmiş. |
| 401 | unauthenticated |
Kimlik bilgisi yok, geçersiz ya da 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/admin-portal-links?organization_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"