Ajouter un hôte

POST /v2/hosts

Ajoute un nouvel hôte à la base de données avec les attribut de l’objet passé dans le corps de la requête. La nouvelle entrée créée est renvoyée dans la réponse, ainsi que l’URI pour la consulter.

Example request:

POST /v2/hosts HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "name": "server1",
    "address": "127.0.0.1",
    "port": 8080,
    "password": "password",
    "isSSL": false,
    "isAdmin": false,
    "isClient": false,
    "isActive": true,
    "isProxy": false
}
Status Codes
  • 201 Created

    Le nouvel hôte a été ajouté avec succès.

    Example response:

    HTTP/1.1 201 Created
    Content-Type: application/json
    
    {
        "name": "server1",
        "address": "127.0.0.1",
        "port": 8080,
        "password": "password",
        "isSSL": false,
        "isAdmin": false,
        "isClient": false,
        "isActive": true,
        "isProxy": false
    }
    

  • 400 Bad Request

    La requête est invalide, soit à cause de paramètres de requête erronés, soit à cause d’un corps de requête invalide.

    Les causes de l’échec de la requête sont données dans le corps de la réponse sour forme d’un tableau JSON.

    Example response:

    HTTP/1.1 400 Bad Request
    Content-Type: application/json
    
    {
        "errors": [
            {
                "message": "Query parameter 'startTrans' : illegal value 'not_a_date'.",
                "errorCode": 4
            },
            {
                "message": "Query parameter 'status' : illegal value 'not_a_status'.",
                "errorCode": 4
            }
        ]
    }
    

  • 415 Unsupported Media Type – Le type de contenu de la requête n’est pas valide pour cette requête.

Response Headers
  • hostURI – L’URI d’accès aux informations du nouvel hôte.