# Ajouter un utilisateur

POST /api/users

  Ajoute un nouvel utilisateur avec les informations renseignées en format JSON dans le corps de la requête.

  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’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. 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’une création vu que l’utilisateur n’a pas de droits courants).

      - `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é créé avec succès

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

    - 401 Unauthorized – Authentification d’utilisateur invalide

  En-têtes de réponse:

    - Location – Le chemin d’accès au nouvel utilisateur créé

  Exemple de requête

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

      {
        "username": "toto",
        "password": "titi",
        "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