Programmer un transfert¶
-
POST
/api/transfers
¶ Programme un nouveau transfert avec les informations renseignées en format JSON dans le corps de la requête.
Request Headers: - Authorization – Les identifiants de l’utilisateur
Request JSON Object: - isServer (bool) – Précise si la gateway était à l’origine du transfert
- rule (string) – L’identifiant de la règle utilisée
- requester (string) – Le nom du compte ayant demandé le transfert
- requested (string) – Le nom du serveur/partenaire auquel le transfert a été demandé
- sourcePath (string) – Le chemin du fichier source
- destPath (string) – Le chemin de destination du fichier
- start (date) – La date de début du transfert (en format ISO 8601)
Status Codes: - 202 Accepted – Le transfert a été lancé avec succès
- 400 Bad Request – Un ou plusieurs des paramètres du transfert sont invalides
- 401 Unauthorized – Authentification d’utilisateur invalide
Response Headers: - Location – Le chemin d’accès au nouveau transfert créé
Exemple de requête
POST https://my_waarp_gateway.net/api/transfers HTTP/1.1 Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== Content-Type: application/json Content-Length: 212 { "isServer": false, "rule": "règle_1", "requester": "toto", "requested": "waarp_sftp", "sourcePath": "chemin/du/fichier", "destPath": "chemin/de/destination", "start": "2019-01-01T02:00:00+02:00" }
Exemple de réponse
HTTP/1.1 202 ACCEPTED Location: https://my_waarp_gateway.net/api/transfers/123