# Consulter un serveur

GET /api/servers/(string: server_name)

  Obsolète depuis la version 0.5.0:

  - Les propriétés `indir` et outDir` de la réponse ont été remplacées par les propriétés `sendDir` et `receiveDir`.

  - La propriété `root``de la réponse a été remplacée par la propriété ``rootDir`.

  - La propriété `workDir` de la réponse a été remplacée par la propriété `tmpReceiveDir`.

  Renvoie les informations du serveur portant le nom `server_name`.

  En-têtes de requête:

    - Authorization – Les identifiants de l’utilisateur

  Status Codes:

    - 200 OK – Les informations du serveur ont été renvoyées avec succès

    - 401 Unauthorized – Authentification d’utilisateur invalide

    - 404 Not Found – Le serveur demandé n’existe pas

  Objet JSON de réponse:

    - name (string) – Le nom du serveur

    - protocol (string) – Le protocole utilisé par le serveur

    - address (string) – L’adresse du serveur (en format [adresse:port])

    - enabled (bool) – Indique si le serveur est activé ou non au démarrage de Gateway.

    - rootDir (string) – Chemin du dossier racine du serveur. Peut être relatif (à la racine de la gateway) ou absolu.

    - receiveDir (string) – Le dossier de réception du serveur. Peut être relatif (à la racine du serveur) ou absolu.

    - sendDir (string) – Le dossier d’envoi du serveur. Peut être relatif (à la racine du serveur) ou absolu.

    - tmpReceiveDir (string) – Le dossier temporaire du serveur. Peut être relatif (à la racine du serveur) ou absolu.

    - authMethods (array) – La liste des valeurs utilisées par le serveur pour s’authentifier auprès des clients externes qui s’y connectent.

    - protoConfig (object) – La configuration du serveur encodé sous forme d’un objet JSON. Cet objet dépend du protocole.

    - authorizedRules (object) –

      Les règles que le serveur est autorisé à utiliser pour les transferts.

      - `sending` (array of string) - Les règles d’envoi.

      - `reception` (array of string) - Les règles de réception.

    - root (string) – Déprécié. La racine du serveur. Peut être relatif (à la racine de la gateway) ou absolu .

    - inDir (string) – Déprécié. Le dossier de réception du serveur. Peut être relatif (à la racine du serveur) ou absolu.

    - outDir (string) – Déprécié. Le dossier d’envoi du serveur. Peut être relatif (à la racine du serveur) ou absolu.

    - workDir (string) – Déprécié. Le dossier temporaire du serveur. Peut être relatif (à la racine du serveur) ou absolu.

  Exemple de requête

      GET https://my_waarp_gateway.net/api/servers/sftp_server HTTP/1.1
      Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

  Exemple de réponse

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

      {
        "name": "sftp_server",
        "protocol": "sftp",
        "address": "localhost:2022",
        "enabled": true,
        "rootDir": "/sftp/root",
        "receiveDir": "in",
        "sendDir": "out",
        "tmpReceiveDir": "tmp",
        "authMethods": ["sftp_server_hostkey"],
        "protoConfig": {},
        "authorizedRules": {
          "sending": ["règle_envoi_1", "règle_envoi_2"],
          "reception": ["règle_récep_1", "règle_récep_2"]
        }
      }