Architectures REST & WebService
zh:休息和 web 服务的体系结构 de:REST- und WebService-Architekturen nl:RUST en WebService platforms it:Architetture di resto e WebService pt:Arquiteturas de descanso e WebService es:Arquitecturas de resto y WebService en:REST and WebService architectures
Introduction
Avec quelle architecture l'API est-elle compatible ?
Explication
L'API Ikoula propose une approche suivant deux architectures: WebService & REST.
WebService
L'architecture WebService s'utilise :
- soit en GET (en formatant les paramètres directement dans l'URI) obligatoire pour les paramètres d'authentification
- soit en POST (en passant les paramètres en tableau de données)
- soit en mixant les 2 (paramètres présents en GET et en POST)
Voici quelques exemples :
- Lister les VM d'un compte
- https://api.ikoula.com/index.php?r=wsflex/vmlist&login=mail@example.com&crypted_password=encrypted_password&signature=xxxxxxxxxxxxxxxxxxxxxxxxxxx
- Récupération des informations d'une VM en utilisant son nom
- https://api.ikoula.com/index.php?r=wsflex/vminfo&login=mail@example.com&crypted_password=encrypted_password&vm_name=1234hpv56789&signature=xxxxxxxxxxxxxxxxxxxxxxxxxxx
REST
L'architecture REST s'utilise en formatant les paramètres dans l'URI et la méthode HTTP adéquate à l'action désirée.
Voici quelques exemples :
- Retourne le statut de la VM "vmid"
- GET /rest/vm/:vmid
- Démarre la VM "vmid"
- POST /rest/vm/:vmid/status/start
- Supprime le snapshot "snapshotName" de la VM "vmid"
- DELETE /rest/vm/:vmid/snapshot/:snapshotName
En passant les paramètres d'authentification (voir WIKI sur l'Authentification et la sécurité pour plus de détails), voici un exemple d'URL :
https://api.ikoula.com/rest/vm/list?login=mail@example.com&crypted_password=encrypted_password&signature=xxxxxxxxxxxxxxxxxxxxxxxxxxx
Cet article vous a semblé utile ?
Activer l'actualisation automatique des commentaires