Uygulamayı yeniden etkinleştir

POST /v1/applications/{application_id}:resume · izin applications:write

Askıdaki uygulamanın status alanını yeniden active yapar; uygulama yeniden token alabilir. İstemci kimlik bilgileri çalışmaya devam eder, ancak askıda iptal edilen refresh token aileleri geri gelmez: uygulamanın kullanıcıları yeni token için yeniden giriş yapar. İsteğin gövdesi yoktur (boş ya da {}). Zaten etkin uygulamada bir şey değişmez; güncel uygulama aynı sürümle döner. Değişiklik yönetim audit'ine application.updated olarak yazılır ve application_changed ile application_status_changed olayları yayımlanır.

İstek

Başlıklar: If-Match: "<sürüm>" (isteğe bağlı). If-Match verilirse değişiklik yalnız o sürüme uygulanır (değilse 412); verilmezse en güncel sürüm kullanılır ve aynı anda başka bir yazar uygulamayı değiştirirse istek yeniden denenir. Yeniden denemeleri güvenli kılmak için Idempotency-Key başlığı gönderin.

Parametre Yer Zorunlu Açıklama
application_id path evet app_ önekli uygulama kimliği.

Yanıt

200 OK; uygulama ("status": "active") ve ETag.

Hatalar

Her hata kararlı bir code taşıyan application/problem+json gövdesidir.

HTTP code Ne zaman
400 malformed_request, unknown_field Geçerli JSON olmayan ya da alan taşıyan bir gövde gönderildi.
401 unauthenticated API anahtarı yok, geçersiz ya da iptal edilmiş.
403 insufficient_permissions Anahtarda applications:write izni yok.
404 not_found Uygulama bu ortamda yok (ya da kimlik bozuk).
412 precondition_failed If-Match'teki sürüm eski.
429 rate_limited Hız sınırı aşıldı; Retry-After'a uyun.
503 service_unavailable Bir bağımlılık geçici olarak erişilemez; sonra yeniden deneyin.

Örnek

curl -X POST https://api.eu.keenauth.com/v1/applications/app_6f8d0cjgbmf0gtn2rg6pscp3cg:resume \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "4"'

CLI: keenauth applications resume app_6f8d0cjgbmf0gtn2rg6pscp3cg --if-match '"4"'