アプリケーションを再開
POST /v1/applications/{application_id}:resume · 権限 applications:write
一時停止中のアプリケーションの status を active に戻し、再びトークンを取得できるようにします。そのクライアント資格情報は引き続き有効ですが、一時停止によって取り消されたリフレッシュトークンファミリーは取り消されたままです。アプリケーションのユーザーは、新しいトークンを得るために再度サインインする必要があります。リクエストにボディはありません(空または {})。既にアクティブなアプリケーションを再開しても何も変わらず、同じバージョンの現在のアプリケーションを返します。この変更は管理監査ログに application.updated として書き込まれ、application_changed および application_status_changed イベントとして公開されます。
リクエスト
ヘッダー: If-Match: "<version>"(任意)。If-Match を付けると、変更はそのバージョンに対してのみ適用されます(それ以外は 412)。付けない場合は最新バージョンが使われ、別の書き込みが同時にアプリケーションを変更すると、リクエストは再試行されます。再試行を安全にするには、Idempotency-Key ヘッダーを送信してください。
| パラメーター | 位置 | 必須 | 説明 |
|---|---|---|---|
application_id |
path | はい | アプリケーション ID。接頭辞は app_。 |
レスポンス
200 OK とアプリケーション("status": "active")、およびその ETag を返します。
エラー
すべてのエラーは、安定した code を持つ application/problem+json 本文です。
| HTTP | code |
発生条件 |
|---|---|---|
| 400 | malformed_request, unknown_field |
有効な JSON ではない、またはフィールドを持つ本文が送信された場合。 |
| 401 | unauthenticated |
API キーがない、無効である、または取り消されている場合。 |
| 403 | insufficient_permissions |
キーに applications:write 権限がない場合。 |
| 404 | not_found |
この環境にアプリケーションが存在しない場合(または ID の形式が不正な場合)。 |
| 412 | precondition_failed |
If-Match のバージョンが古い場合。 |
| 429 | rate_limited |
レート制限を超えた場合。Retry-After に従ってください。 |
| 503 | service_unavailable |
依存先が一時的に利用できない場合。後で再試行してください。 |
例
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"'