Lister les certificats¶
-
GET
/api/servers/
(string: server)/accounts/
(string: login)/certificates
¶ Renvoie une liste des certificats emplissant les critères donnés en paramètres de requête.
- Request Headers
Authorization – Les identifiants de l’utilisateur
- Parameters
limit (int) – Le nombre maximum de résultats souhaités (défaut: 20)
offset (int) – Le numéro du premier résultat souhaité (défaut: 0)
sort ([name+|name-]) – Le paramètre selon lequel les certificats seront triés (défaut: name+)
- Status Codes
200 OK – La liste a été renvoyée avec succès
400 Bad Request – Un ou plusieurs des paramètres de requêtes sont invalides
401 Unauthorized – Authentification d’utilisateur invalide
404 Not Found – Le serveur ou le compte demandés n’existent pas
- Response JSON Object
certificates (array) – La liste des certificats demandés
- Response JSON Array of Objects
name (string) – Le nom du certificat
privateKey (string) – La clé privée du certificat
publicKey (string) – La clé publique du certificat
certificate (string) – Le certificat de l’entité
Exemple de requête
GET https://my_waarp_gateway.net/api/servers/serveur_sftp/accounts/toto/certificates?limit=5 HTTP/1.1 Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Exemple de réponse
HTTP/1.1 200 OK Content-Type: application/json Content-Length: 453 { "certificates": [{ "name": "certificat_toto_1", "privateKey": "<clé privée 1>", "publicKey": "<clé publique 1>", "cert": "<certificat 1>" },{ "name": "certificat_toto_2", "privateKey": "<clé privée 2>", "publicKey": "<clé publique 2>", "cert": "<certificat 2>" }] }