Lister les utilisateurs¶
-
GET
/api/users
¶ Renvoie une liste des utilisateurs remplissant les critères donnés en paramètres de requête.
Request Headers: - Authorization – Les identifiants de l’utilisateur
Parameters: - limit (int) – Le nombre maximum de résultats souhaités (défaut: 20)
- offset (int) – Le numéro du premier résultat souhaité (défaut: 0)
- sort ([username+|username-]) – Le paramètre selon lequel les utilisateurs seront triés (défaut: username+)
Status Codes: - 200 OK – La liste a été renvoyée avec succès
- 400 Bad Request – Un ou plusieurs des paramètres de requêtes sont invalides
- 401 Unauthorized – Authentification d’utilisateur invalide
Response JSON Object: - users (array) – La liste des utilisateur demandés
Response JSON Array of Objects: - username (string) – Le nom de l’utilisateur
Resjsonerr object perms: 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.
- 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_gateway.net/api/users?limit=10&sort=username- HTTP/1.1 Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Exemple de réponse
HTTP/1.1 200 OK Content-Type: application/json Content-Length: 76 { "users": [{ "username": "tutu", "perms": { "transfers":"r--", "servers":"rw-", "partners":"rw-", "rules":"---", "users":"---" } },{ "username": "toto", "perms": { "transfers":"rw-", "servers":"r--", "partners":"r--", "rules":"rwd", "users":"---" } }] }