Consulter un utilisateur

GET /api/users/(string: username)

Renvoie l’utilisateur demandé.

Paramètres:
  • username – Le login de l’utilisateur concerné

En-têtes de requête:
Status Codes:
  • 200 OK – L’utilisateur a été renvoyé avec succès

  • 401 Unauthorized – Authentification d’utilisateur invalide

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

Objet JSON de réponse:
  • username (string) – Le nom de l’utilisateur

  • perms (object) –

    Les droits de l’utilisateur. Chaque attribut correspond à un élément sur lequel l’utilisateur 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.

    • 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.

Exemple de requête

GET https://my_waarp_transfer.net/api/users/toto HTTP/1.1
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

Exemple de réponse

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 105

{
  "username": "toto",
  "perms": {
    "transfers":"rw-",
    "servers":"r--",
    "partners":"r--",
    "rules":"rwd",
    "users":"---"
  }
}