# Ajouter une clé cryptographique

POST /api/keys

  Ajoute une nouvelle clé cryptographique 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:

    - name (string) – Le nom de la clé cryptographique.

    - type (string) –

      Le type de la clé cryptographique. Les valeurs acceptées sont :

      - `AES` pour les clés de (dé)chiffrement AES

      - `HMAC` pour les clés de signature HMAC

      - `PGP-PUBLIC` pour les clés PGP publiques

      - `PGP-PRIVATE` pour les clés PGP privées

    - key (string) – La représentation textuelle de la clé. Si la clé n’est pas nativement en format textuel, celle-ci doit être convertie en Base64 avant son envoi.

  Status Codes:

    - 201 Created – La clé a été créée avec succès

    - 400 Bad Request – Un ou plusieurs des paramètres de la requête sont invalides

    - 401 Unauthorized – Authentification d’utilisateur invalide

  En-têtes de réponse:

    - Location – Le chemin d’accès à la nouvelle clé créée

  Exemple de requête

      POST https://my_waarp_transfer.net/api/keys HTTP/1.1
      Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
      Content-Type: application/json
      Content-Length: 103

      {
        "name": "aes-key",
        "type": "AES",
        "privateKey": "0123456789abcdefhijklABCDEFHIJKL"
      }

  Exemple de réponse

      HTTP/1.1 201 CREATED
      Location: https://my_waarp_transfer.net/api/keys/aes-key