Remplacer un utilisateur

PUT /api/users/(string: username)

Remplace l’utilisateur demandé par celui renseigné en JSON.

En-têtes de requête:

• Authorization – Les identifiants de l’utilisateur

Objet JSON de requête:

• username (string) – Le nom de l’utilisateur

• password (string) – Le mot de passe de l’utilisateur

• perms (object) –

  Les droits de l’utilisateur. Chaque attribut correspond à un élément sur lequel l” utilisateurs peut agir, et leur valeur indique les actions autorisées. Les différentes actions possibles sont lecture (r), écriture (w) et suppression (d). Ces droits sont renseignés avec une syntaxe similaire à chmod où l’autorisation d’exécution a été remplacée par la suppression. Les opérateurs de changement d’état + et - peuvent également être utilisés pour ajouter ou retirer un type de droit aux droits courants, et l’opérateur = pour les écraser. (Note: l’opérateur - est inconséquent dans le cadre d’un remplacement, les droits courants seront écrasés dans tous les cas).

  • transfers (string) - Les droits sur les transferts. (Note:

    les transferts ne peuvent pas être supprimés).

  • servers (string) - Les droits sur les serveurs locaux.

  • partners (string) - Les droits sur les partenaires distants.

  • rules (string) - Les droits sur les règles de transfert.

  • users (string) - Les droits sur les autres utilisateurs.

Status Codes:

• 201 Created – L’utilisateur a été remplacé avec succès

• 400 Bad Request – Un ou plusieurs des paramètres de l’utilisateur sont invalides

• 401 Unauthorized – Authentification d’utilisateur invalide

• 404 Not Found – L’utilisateur demandé n’existe pas

En-têtes de réponse:

• Location – Le chemin d’accès à l’utilisateur modifié

Exemple de requête

PUT https://my_waarp_gateway.net/api/users/toto HTTP/1.1
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
Content-Length: 157

{
  "username": "toto_new",
  "password": "titi_new",
  "perms": {
    "transfers":"=rw-",
    "servers":"=r--",
    "partners":"=r--",
    "rules":"=rwd",
    "users":"=---"
  }
}

Exemple de réponse

HTTP/1.1 201 CREATED
Location: https://my_waarp_gateway.net/api/users/toto_new