Consulter un serveur
====================

.. http:get:: /api/servers/(string:server_name)

   .. deprecated:: 0.2.0

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

   .. deprecated:: 0.2.0

      La propriété ``inDir`` de la réponse a été remplacée par la propriété
      ``receiveDir``.

   .. deprecated:: 0.2.0

      La propriété ``outDir`` de la réponse a été remplacée par la propriété
      ``sendDir``.

   .. deprecated:: 0.2.0

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

   :reqheader Authorization: Les identifiants de l'utilisateur

   :statuscode 200: Les informations du serveur ont été renvoyées avec succès
   :statuscode 401: Authentification d'utilisateur invalide
   :statuscode 404: Le serveur demandé n'existe pas

   :resjson string name: Le nom du serveur
   :resjson string protocol: Le protocole utilisé par le serveur
   :resjson string address: L'adresse du serveur (en format [adresse:port])
   :resjson string root: La racine du serveur. Peut être relatif (à la racine
      de *transfer*) ou absolu (déprécié).
   :resjson string inDir: Le dossier de réception du serveur. Peut être
      relatif (à la racine du serveur) ou absolu. (déprécié)
   :resjson string outDir: Le dossier d'envoi du serveur. Peut être
      relatif (à la racine du serveur) ou absolu. (déprécié)
   :resjson string workDir: Le dossier temporaire du serveur. Peut être
      relatif (à la racine du serveur) ou absolu. (déprécié)
   :resjson string rootDir: Chemin du dossier racine du serveur. Peut être
      relatif (à la racine de *transfer*) ou absolu.
   :resjson string receiveDir: Le dossier de réception du serveur. Peut
      être relatif (à la racine du serveur) ou absolu.
   :resjson string sendDir: Le dossier d'envoi du serveur. Peut être
      relatif (à la racine du serveur) ou absolu.
   :resjson string tmpReceiveDir: Le dossier temporaire du serveur. Peut
      être relatif (à la racine du serveur) ou absolu.
   :resjson object protoConfig: La configuration du serveur encodé sous forme
      d'un objet JSON. Cet objet dépend du protocole.
   :resjson object authorizedRules: 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.



   **Exemple de requête**

   .. code-block:: http

      GET https://my_waarp_transfer.net/api/servers/r66 HTTP/1.1
      Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

   **Exemple de réponse**

   .. code-block:: http

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

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