API Rest Kiwi Backup¶
Authentification¶
L’authentification se fait avec un token lié à l’utilisateur. Il vous est fourni sur demande et affiché dans votre interface d’administration.
Avant propos¶
Remplacez [TOKEN] par la valeur du jeton fourni. Replacez l’url de l’api par l’url de votre webadmin:
sante https://admin.sante.kiwi-backup.com
cloud https://kiwi4.kiwi-backup.com
Pour certaines API il y a plusieurs types de sortie possible pour la même API, il est donc possible de générer une sortie en json ou en csv, si cela est possible les exemples proposerons les deux solutions.
Liste des machines¶
curl -H "X-AUTH-TOKEN:[TOKEN]" "https://admin.sante.kiwi-backup.com/api/machines.json"
curl -H "X-AUTH-TOKEN:[TOKEN]" "https://admin.sante.kiwi-backup.com/api/machines.csv"
Liste des contrats¶
curl -H "X-AUTH-TOKEN:[TOKEN]" "https://admin.sante.kiwi-backup.com/api/contrats.csv"
curl -H "X-AUTH-TOKEN:[TOKEN]" "https://admin.sante.kiwi-backup.com/api/contrats.json"
Liste des machines en alerte¶
curl -H "X-AUTH-TOKEN:[TOKEN]" "https://admin.sante.kiwi-backup.com/api/machines_alerte.csv"
curl -H "X-AUTH-TOKEN:[TOKEN]" "https://admin.sante.kiwi-backup.com/api/machines_alerte.json"
Création d’un contrat en passant un fichier .json from the current folder of this file.¶
curl -H "X-AUTH-TOKEN:[TOKEN]" -d @file.json "https://admin.sante.kiwi-backup.com/api/add/contrat.json"
Création d’un contrat en passant les champs qui vous interesse.¶
curl -H "X-AUTH-TOKEN:[TOKEN]" -d '{"eid":"000000000000000000000001", "libelle":"MonContrat", "volume_disponible":10000, "nb_machines":99, "historique": 90, "email_alerte": "monemail@free.fr"}' "https://admin.sante.kiwi-backup.com/api/add/contrat.json"
Voir un contrat spécifique¶
([CONTRACT_ID] = id du contrat désiré)
curl -H "X-AUTH-TOKEN:[TOKEN]" "https://admin.sante.kiwi-backup.com/api/contrat/[CONTRACT_ID]"
Mettre à jour un contrat¶
Il est possible d’update les informations suivante: “email_alerte”, “nb_machines”, “volume_disponible”, “libelle”, “historique”.
curl -H "X-AUTH-TOKEN:[TOKEN]" -d @file.json "https://admin.sante.kiwi-backup.com/api/edit/contrat.json/[CONTRACT_ID]"
ou
curl -H "X-AUTH-TOKEN:[TOKEN]" -d '{"volume_disponible":10000, "email_alerte": "exemple@exemple.com"}' "https://admin.sante.kiwi-backup.com/api/edit/contrat.json/[CONTRACT_ID]"