Voir la source de Comment utiliser l'API Cloud Privé d’Ikoula

<span data-link_translate_fr_title="Comment utiliser l'API Cloud Privé d’Ikoula"  data-link_translate_fr_url="Comment utiliser l'API Cloud Privé d’Ikoula"></span>[[:fr:Comment utiliser l'API Cloud Privé d’Ikoula]][[fr:Comment utiliser l'API Cloud Privé d’Ikoula]]
<span data-link_translate_he_title="כיצד להשתמש ב- API פרטיים של ענן Ikoula"  data-link_translate_he_url="%D7%9B%D7%99%D7%A6%D7%93+%D7%9C%D7%94%D7%A9%D7%AA%D7%9E%D7%A9+%D7%91-+API+%D7%A4%D7%A8%D7%98%D7%99%D7%99%D7%9D+%D7%A9%D7%9C+%D7%A2%D7%A0%D7%9F+Ikoula"></span>[[:he:כיצד להשתמש ב- API פרטיים של ענן Ikoula]][[he:כיצד להשתמש ב- API פרטיים של ענן Ikoula]]
<span data-link_translate_ro_title="Cum să utilizaţi nor Ikoula privat API"  data-link_translate_ro_url="Cum+s%C4%83+utiliza%C5%A3i+nor+Ikoula+privat+API"></span>[[:ro:Cum să utilizaţi nor Ikoula privat API]][[ro:Cum să utilizaţi nor Ikoula privat API]]
<span data-link_translate_ru_title="Как использовать API частных облачных Ikoula"  data-link_translate_ru_url="%D0%9A%D0%B0%D0%BA+%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D1%8C+API+%D1%87%D0%B0%D1%81%D1%82%D0%BD%D1%8B%D1%85+%D0%BE%D0%B1%D0%BB%D0%B0%D1%87%D0%BD%D1%8B%D1%85+Ikoula"></span>[[:ru:Как использовать API частных облачных Ikoula]][[ru:Как использовать API частных облачных Ikoula]]
<span data-link_translate_pl_title="Jak korzystać z interfejsu API prywatne Cloud Ikoula"  data-link_translate_pl_url="Jak+korzysta%C4%87+z+interfejsu+API+prywatne+Cloud+Ikoula"></span>[[:pl:Jak korzystać z interfejsu API prywatne Cloud Ikoula]][[pl:Jak korzystać z interfejsu API prywatne Cloud Ikoula]]
<span data-link_translate_ja_title="クラウド Ikoula 専用 API を使用する方法"  data-link_translate_ja_url="%E3%82%AF%E3%83%A9%E3%82%A6%E3%83%89+Ikoula+%E5%B0%82%E7%94%A8+API+%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95"></span>[[:ja:クラウド Ikoula 専用 API を使用する方法]][[ja:クラウド Ikoula 専用 API を使用する方法]]
<span data-link_translate_ar_title="كيفية استخدام API الخاصة "عكلة سحابة""  data-link_translate_ar_url="%D9%83%D9%8A%D9%81%D9%8A%D8%A9+%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85+API+%D8%A7%D9%84%D8%AE%D8%A7%D8%B5%D8%A9+%22%D8%B9%D9%83%D9%84%D8%A9+%D8%B3%D8%AD%D8%A7%D8%A8%D8%A9%22"></span>[[:ar:كيفية استخدام API الخاصة "عكلة سحابة"]][[ar:كيفية استخدام API الخاصة "عكلة سحابة"]]
<span data-link_translate_zh_title="如何使用云 Ikoula 私有 API"  data-link_translate_zh_url="%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8%E4%BA%91+Ikoula+%E7%A7%81%E6%9C%89+API"></span>[[:zh:如何使用云 Ikoula 私有 API]][[zh:如何使用云 Ikoula 私有 API]]
<span data-link_translate_de_title="Wie Sie die private Cloud Ikoula-API verwenden"  data-link_translate_de_url="Wie+Sie+die+private+Cloud+Ikoula-API+verwenden"></span>[[:de:Wie Sie die private Cloud Ikoula-API verwenden]][[de:Wie Sie die private Cloud Ikoula-API verwenden]]
<span data-link_translate_nl_title="Hoe de wolk Ikoula privé API kunt gebruiken"  data-link_translate_nl_url="Hoe+de+wolk+Ikoula+priv%C3%A9+API+kunt+gebruiken"></span>[[:nl:Hoe de wolk Ikoula privé API kunt gebruiken]][[nl:Hoe de wolk Ikoula privé API kunt gebruiken]]
<span data-link_translate_it_title="Come utilizzare l'API privata Cloud Ikoula"  data-link_translate_it_url="Come+utilizzare+l%27API+privata+Cloud+Ikoula"></span>[[:it:Come utilizzare l'API privata Cloud Ikoula]][[it:Come utilizzare l'API privata Cloud Ikoula]]
<span data-link_translate_pt_title="Como usar a API de Ikoula de nuvem privada"  data-link_translate_pt_url="Como+usar+a+API+de+Ikoula+de+nuvem+privada"></span>[[:pt:Como usar a API de Ikoula de nuvem privada]][[pt:Como usar a API de Ikoula de nuvem privada]]
<span data-link_translate_es_title="Cómo utilizar la API privada de nube Ikoula"  data-link_translate_es_url="C%C3%B3mo+utilizar+la+API+privada+de+nube+Ikoula"></span>[[:es:Cómo utilizar la API privada de nube Ikoula]][[es:Cómo utilizar la API privada de nube Ikoula]]
<span data-link_translate_en_title="How to use the Cloud Ikoula private API"  data-link_translate_en_url="How+to+use+the+Cloud+Ikoula+private+API"></span>[[:en:How to use the Cloud Ikoula private API]][[en:How to use the Cloud Ikoula private API]]


<!--T:1-->
Lors de votre inscription au service {{cloud privé}} d’{{iKoula}}, vous avez reçu un mail avec une clé d'API et une clé secrète.
Ces informations vous permettrons de vous connecter à l'API {{cloud privé}} d’{{iKoula}}.

<!--T:2-->
URL API : https://{{Template:Cloud}}stack.ikoula.com/client/api

<!--T:3-->
Les spécifications de l'API administrateur de domaine et utilisateur sont respectivement :
<!--T:4-->
* Admin : http://{{Template:Cloud}}stack.apache.org/docs/api/apidocs-4.2/TOC_Domain_Admin.html
* User : http://{{Template:Cloud}}stack.apache.org/docs/api/apidocs-4.2/TOC_User.html

<!--T:5-->
Pour l'utililsation de l'API, il faut :
<!--T:6-->
* Votre clé d'API
* Votre clé secréte
* Envoyer les requêtes sur "https://{{Template:Cloud}}stack.ikoula.com/client/api" avec une méthode du protocole HTTP
* Traiter les retours XML ou JSON (au choix)

<!--T:7-->
Exemple de requete a l'API utilisant la methode GET :
<!--T:8-->
<syntaxhighlight lang="php" line>
https://cloudstack.ikoula.com/client/api/
        ?command=deployVirtualMachine
        &serviceOfferingId=1
        &diskOfferingId=1
        &templateId=2
        &zoneId=4
        &apiKey=miVr6X7u6bN_EJTVwZ0nUkkJbPmY3y2bciKwFQ
        &signature=Lxx1DM40AjcXU%2FcaiK8RAP0O1hU%3D
</syntaxhighlight>
<!--T:9-->
* La ligne 1 correspond au point de d’entrée (le lien vers l'API {{cloud privé}} d’{{iKoula}})
* La ligne 2 correspond a la commande a envoyer, ici on veut crée une nouvelle VM
* La ligne 3-6 correspondent aux différents paramètres de la commande. Vous pouvez rajouter le champs  <span class="notranslate">"response"</span> qui définie le format de retour avec le paramètre (XML/JSON)
* La ligne 7 contient votre clé d'API (Ici est une clé d'exemple invalide, a remplacer par la votre)
* La ligne 8 est la signature générée à partir de la commande et de votre clé secrète

<!--T:10-->
==Comment générer la signature==

<!--T:11-->
Il faut s'assurer que tout les espaces sont remplacés par "'''%20'''" au lieu de "'''+'''"

<!--T:12-->
Il faut trier par ordre alphabétique les champs envoyés. Attention à mettre les paramètres les uns après les autres séparés par un & (et commercial)et la chaîne de paramètres en minuscule.


<!--T:13-->
Exemple de string de paramètres : <syntaxhighlight lang="php" enclose="none">apikey=mivr6x7u6bn_ejtvwz0nukkjbpmy3y2bcikwfq&command=listvirtualmachines&domainId=5</syntaxhighlight>
 

Enfin appliquer un hmac_SHA1 sur la chaîne générée avec comme clé de hashage votre clé secréte. Pour envoyer la requête il vous suffit de rajouter le champs signature avec la signature générée

<!--T:14-->
$args est un tableau associatif de tous les arguments
<syntaxhighlight lang="php" line>
<?
// classement par clef
ksort($args);
$query = http_build_query($args);
// {{Template:Sécurité}} pour l'encodage des espaces
$query = str_replace("+", "%20", $query);
// minuscule
strtolower($query)
// calcul du hash
$hash = hash_hmac("SHA1",  $query, $secretKey, true);
// encodage en base 64
$signature = base64_encode($hash);
?>
</syntaxhighlight>

[[Category:cloud public]]
[[Category:cloud privé]]
[[Catégorie:API]]
[[Catégorie:Cloud]]
<br />
<comments />