Reprendre une application
POST /v1/applications/{application_id}:resume · autorisation applications:write
Remet le status d'une application suspendue sur active, afin qu'elle puisse de nouveau obtenir des jetons. Ses identifiants client restent valides, mais les familles de jetons d'actualisation révoquées par la suspension restent révoquées : les utilisateurs de l'application doivent se reconnecter pour obtenir de nouveaux jetons. La demande n'a pas de corps (vide ou {}). Reprendre une application déjà active ne change rien et renvoie l'application courante avec la même version. La modification est écrite dans le journal d'audit de gestion sous application.updated et publiée sous forme d'événements application_changed et application_status_changed.
Requête
En-têtes : If-Match: "<version>" (facultatif). Avec If-Match, la modification ne s'applique qu'à cette version (412 sinon) ; sans lui, la dernière version est utilisée et la requête est relancée si un autre écrivain modifie l'application en même temps. Envoyez un en-tête Idempotency-Key pour rendre les nouvelles tentatives sûres.
| Paramètre | Dans | Obligatoire | Description |
|---|---|---|---|
application_id |
path | oui | Identifiant de l'application, préfixé app_. |
Réponse
200 OK avec l'application ("status": "active") et son ETag.
Erreurs
Chaque erreur est un corps application/problem+json avec un code stable.
| HTTP | code |
Quand |
|---|---|---|
| 400 | malformed_request, unknown_field |
Un corps a été envoyé qui n'est pas du JSON valide ou contient un champ inconnu. |
| 401 | unauthenticated |
La clé d'API est absente, invalide ou révoquée. |
| 403 | insufficient_permissions |
La clé ne dispose pas de l'autorisation applications:write. |
| 404 | not_found |
L'application n'existe pas dans cet environnement (ou l'identifiant est mal formé). |
| 412 | precondition_failed |
La version dans If-Match est périmée. |
| 429 | rate_limited |
La limite de débit a été dépassée ; respectez Retry-After. |
| 503 | service_unavailable |
Une dépendance est temporairement indisponible ; réessayez plus tard. |
Exemple
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"'