CLI için ortamlarınızı listeleyin

GET https://api.keenauth.com/v1/environments · keenauth env list çağırır

CLI ile çalışabileceğiniz ortamları listeler: keenauth login ile oturum açtığınız hesabın, hesap, proje ya da ortam ataması yoluyla pano rolünüz olan ortamları. Silinmiş ortamlar ve silinmiş projelerin ortamları listelenmez. Bu ucu kendiniz çağırmazsınız; keenauth env list listeyi gösterir, keenauth env use <environment_id> birini seçer.

Birden çok hesabın üyesiyseniz liste yalnız geçerli oturumunuzun hesabının ortamlarını içerir; diğer hesabın ortamlarını görmek için o hesapla oturum açın. Hiçbir ortamda rolünüz yoksa liste boştur.

İstek

Başlıklar:

Başlık Zorunlu Açıklama
Authorization evet DPoP <erişim tokenı>: oturum açtığınızda CLI'nin aldığı erişim tokenı.
DPoP evet Bu istek için (htm GET, htu sorgusuz https://api.keenauth.com/v1/environments), erişim tokenının bağlı olduğu anahtarla imzalanmış DPoP kanıtı; erişim tokenının özetini ve sunucu nonce'unu taşır.

Sorgu parametreleri:

Parametre Açıklama
limit Sayfa boyutu, 1–100; varsayılan 20.
after Önceki sayfanın list_metadata.after değeri.

Liste yalnız ileri sayfalanır: before ve order validation_failed ile reddedilir.

Yanıt

200 OK, Cache-Control: no-store ile, en yeni ortam önce:

Alan Açıklama
data[].id Ortam (env_…); keenauth env use ve yönetim tokenı isteğinde kullanılır.
data[].slug Ortamın DNS etiketi (<slug>.<region>.keenauth.app).
data[].display_name Ortamın adı.
data[].environment_type production, staging ya da development.
data[].region Ortam verisinin bölgesi, örneğin eu.
data[].project_id Proje (proj_…).
data[].project_name Projenin adı.
data[].account_id Hesap (acct_…).
data[].dashboard_role Ortamdaki pano rolünüz (owner, admin, developer, support, billing, viewer; yalnız özel roller kapsıyorsa custom).
data[].created_at Ortamın oluşturulma zamanı (RFC 3339, UTC).
list_metadata.after Sonraki sayfanın imleci; son sayfada null.
list_metadata.before Her zaman null.

İmleç size ve hesaba bağlıdır; başka bir kullanıcıda ya da başka bir oturumda çalışmaz.

Hatalar

Durum Kod Ne zaman
400 invalid_cursor after imleci bozuk, değiştirilmiş ya da başka bir kullanıcı veya hesap için verilmiş.
401 unauthenticated Erişim tokenı gönderilmedi.
401 invalid_token Erişim tokenı geçersiz, süresi dolmuş ya da CLI'nin değil; keenauth login ile yeniden oturum açın.
401 invalid_dpop_proof DPoP kanıtı yok, birden çok ya da istekle veya tokenın anahtarıyla uyuşmuyor.
401 use_dpop_nonce DPoP-Nonce yanıt başlığındaki nonce'u taşıyan bir kanıtla yeniden deneyin.
401 insufficient_user_authentication Çok faktörlü kimlik doğrulama gerekir; yeniden oturum açın.
422 validation_failed limit 1–100 arası bir tamsayı değil, bir parametre tekrarlanmış ya da before veya order gönderilmiş.

Örnek

curl "https://api.keenauth.com/v1/environments?limit=50" \
  -H "Authorization: DPoP $ACCESS_TOKEN" \
  -H "DPoP: $DPOP_PROOF"