Différences entre versions de « Exemples d'utilisation de l'API »

De Ikoula Wiki
Jump to navigation Jump to search
 
(9 versions intermédiaires par 4 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
 +
<span data-link_translate_fr_title="Exemples d'utilisation de l'API"  data-link_translate_fr_url="Exemples d'utilisation de l'API"></span>[[:fr:Exemples d'utilisation de l'API]][[fr:Exemples d'utilisation de l'API]]
 
<span data-link_translate_he_title="דוגמאות לשימוש ה-API"  data-link_translate_he_url="%D7%93%D7%95%D7%92%D7%9E%D7%90%D7%95%D7%AA+%D7%9C%D7%A9%D7%99%D7%9E%D7%95%D7%A9+%D7%94-API"></span>[[:he:דוגמאות לשימוש ה-API]][[he:דוגמאות לשימוש ה-API]]
 
<span data-link_translate_he_title="דוגמאות לשימוש ה-API"  data-link_translate_he_url="%D7%93%D7%95%D7%92%D7%9E%D7%90%D7%95%D7%AA+%D7%9C%D7%A9%D7%99%D7%9E%D7%95%D7%A9+%D7%94-API"></span>[[:he:דוגמאות לשימוש ה-API]][[he:דוגמאות לשימוש ה-API]]
 
<span data-link_translate_ro_title="Exemple de utilizare a API"  data-link_translate_ro_url="Exemple+de+utilizare+a+API"></span>[[:ro:Exemple de utilizare a API]][[ro:Exemple de utilizare a API]]
 
<span data-link_translate_ro_title="Exemple de utilizare a API"  data-link_translate_ro_url="Exemple+de+utilizare+a+API"></span>[[:ro:Exemple de utilizare a API]][[ro:Exemple de utilizare a API]]
Ligne 13 : Ligne 14 :
 
<span data-link_translate_en_title="Examples of using the API"  data-link_translate_en_url="Examples+of+using+the+API"></span>[[:en:Examples of using the API]][[en:Examples of using the API]]
 
<span data-link_translate_en_title="Examples of using the API"  data-link_translate_en_url="Examples+of+using+the+API"></span>[[:en:Examples of using the API]][[en:Examples of using the API]]
  
−
 
+
#REDIRECT [[Comment_utiliser_l'API_d’Ikoula]]
−
<!-- Début de l'article. Placez votre texte ci-après et n'hésitez pas à personnaliser les chapitres selon votre besoin -->
 
−
 
 
−
 
 
−
 
 
−
==Introduction==
 
−
Comment utiliser l'API à travers quelques exemples concrets et fonctionnels.
 
−
 
 
−
==Fonctions pour les exemples==
 
−
<syntaxhighlight lang="php">
 
−
// Chemin local vers la clé publique téléchargée sur https://api.ikoula.com/downloads/Ikoula.API.RSAKeyPub.pem
 
−
define('API_PUB_KEY_PATH', dirname(__FILE__) . '/Ikoula.API.RSAKeyPub.pem');
 
−
 
 
−
// Fonction de chiffrement du mot de passe via la clé publique Ikoula
 
−
function opensslEncryptPublic($password)
 
−
{
 
−
// Vérification de la présence de la clé publique
 
−
if(file_exists(API_PUB_KEY_PATH))
 
−
{
 
−
if(!empty($password))
 
−
{
 
−
// on récupère la clé public
 
−
$publicKey = openssl_pkey_get_public('file://'.realpath(API_PUB_KEY_PATH));
 
−
 
 
−
// S'il n'y as pas eu d'erreurs lors de la récupération de la clé publique, on continue
 
−
if ($publicKey !== FALSE)     
 
−
{
 
−
// Si chiffrement clé publique OK
 
−
if(openssl_public_encrypt($password, $crypted, $publicKey) === TRUE) 
 
−
{
 
−
// Renvoie du mot de passe crypté
 
−
return $crypted;     
 
−
}
 
−
else
 
−
{
 
−
return NULL;
 
−
}
 
−
}
 
−
else
 
−
return NULL;
 
−
}
 
−
else
 
−
return NULL;
 
−
}
 
−
else
 
−
{
 
−
echo("Erreur - la clé publique n'est pas présente.\n");
 
−
return NULL;
 
−
}
 
−
}
 
−
 
 
−
// Fontction de création de la signature en fonction des paramètres présents
 
−
function createSignature($params=array())
 
−
{
 
−
    $signature = null;
 
−
 
 
−
// Si il y a au moins un paramètre
 
−
    if (count($params) > 0)
 
−
    {
 
−
        //debug('create signature');
 
−
        //debug($params);
 
−
       
 
−
        // Triage des paramètres dans le sens croissant
 
−
        ksort($params);
 
−
       
 
−
        // Encodage des paramètres
 
−
        $query = http_build_query($params);
 
−
 
 
−
// Encodage des signes "plus "+"
 
−
        $query = str_replace("+", "%20", $query);
 
−
 
 
−
// Transformation de la chaîne de caractères en minuscule
 
−
        $query = strtolower($query);
 
−
 
 
−
$public_key = "";
 
−
        // Si le fichier existe, on va récupérer la clé
 
−
        if (file_exists(API_PUB_KEY_PATH))
 
−
        {
 
−
            $public_key = trim(
 
−
                    str_replace(
 
−
                            array("\n", '-----BEGIN PUBLIC KEY-----','-----END PUBLIC KEY-----'),
 
−
                            array('', '', ''),
 
−
                            file_get_contents(API_PUB_KEY_PATH)
 
−
                        )
 
−
                    );
 
−
        }
 
−
 
 
−
// Hashage des paramètres
 
−
        $hash = hash_hmac("SHA1", $query, $public_key, true);
 
−
 
 
−
// Encodage en base64
 
−
        $signature = base64_encode($hash);
 
−
    }
 
−
 
 
−
return $signature;
 
−
}
 
−
 
 
−
// Fonction facilitant l'envoie des requêtes vers l'API Ikoula
 
−
function send_request ($rest, $url_param, $params=array())
 
−
{
 
−
// initialisation de CURL
 
−
$ch = curl_init();
 
−
if($ch)
 
−
{
 
−
// Si on a des info on utilise l'api REST sinon on utilise l'api standard (WebService)
 
−
if($rest)
 
−
$url = "https://api.ikoula.com/rest/" . $url_param;
 
−
else
 
−
$url = "https://api.ikoula.com/?r=" . $url_param;
 
−
 
 
−
 
−
// si on est en REST on rajoute le type d'appel (POST,DELETE,PUT,GET,...) sinon on passe en POST
 
−
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, ($rest)?$rest:"POST");
 
−
// Si il y a des paramètres on les rajoute dans la requête
 
−
if(is_array($params) && count($params) > 0)
 
−
{
 
−
$params_str = http_build_query($params);
 
−
}
 
−
if($rest=='POST')
 
−
{
 
−
// on rentre le nom de paramètre présent dans la requête
 
−
curl_setopt($ch,CURLOPT_POST, true);
 
−
curl_setopt($ch,CURLOPT_POSTFIELDS, $params_str);
 
−
}
 
−
else
 
−
{
 
−
$url .= (strpos($url,'?') === false ? '?' : '&').$params_str;
 
−
}
 
−
 
−
// On ajoute l'url
 
−
curl_setopt($ch, CURLOPT_URL, $url);
 
−
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
 
−
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
 
−
curl_setopt($ch, CURLOPT_HEADER, 1);
 
−
curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
 
−
// on vire les en-tête HTTP pour avoir directement le retour
 
−
curl_setopt($ch, CURLOPT_HEADER, false);
 
−
 
 
−
// exécution de la requête
 
−
$data = curl_exec($ch);
 
−
 
 
−
// fermeture de l'objet
 
−
curl_close($ch);
 
−
 
 
−
// retourne la réponse
 
−
return($data);
 
−
}
 
−
return null;
 
−
}
 
−
</syntaxhighlight>
 
−
 
 
−
==Appels API==
 
−
<syntaxhighlight lang="php">
 
−
//login
 
−
$login = 'mail@test.com';
 
−
//on crypte le mot de passe
 
−
$crypted_password = base64_encode(opensslEncryptPublic('MOT_DE_PASSE_A_CRYPTER'));
 
−
//liste des VM - retour en JSON
 
−
 
 
−
//liste des paramètres que l'on souhaite envoyer à l'API (pour générer la signature)
 
−
$parameters = array('login' => $login, 'crypted_password' => $crypted_password, 'format' => 'json');
 
−
//on génère la signature
 
−
$signature = createSignature($parameters);
 
−
//on ajoute la signature dans les paramètres à envoyer lors de l'appel à l'API
 
−
$parameters['signature'] = $signature;
 
−
//on fait l'appel API
 
−
$data = send_request(false,'wsflex/vmlist',$parameters);
 
−
print_r($data); //appel WebService
 
−
$data2 = send_request('GET','vm/list',$parameters);
 
−
print_r($data2); //appel REST
 
−
 
 
−
//informations d'une VM - retour en XML
 
−
 
 
−
//liste des paramètres que l'on souhaite envoyer à l'API (pour générer la signature)
 
−
$parameters = array('login' => $login, 'crypted_password' => $crypted_password, 'format' => 'xml', 'subscr_id' => 12345);
 
−
//on génère la signature
 
−
$signature = createSignature($parameters);
 
−
//on ajoute la signature dans les paramètres à envoyer lors de l'appel à l'API
 
−
$parameters['signature'] = $signature;
 
−
//on fait l'appel API
 
−
$data = send_request(false,'wsflex/vminfo',$parameters);
 
−
print_r($data); //appel WebService
 
−
$data2 = send_request('GET','vm/'.$parameters['subscr_id'],$parameters);
 
−
print_r($data2); //appel REST
 
−
 
−
</syntaxhighlight>
 
−
 
 
−
==Erreurs usuelles==
 
−
;Permission Denied
 
−
: Signifie que l'utilisateur utilisé dans l'API n'a pas le droit d'accéder à l'information demandée ou d'effectuer l'action souhaitée.
 
−
;Unable to decrypt password
 
−
: Signifie que le paramètre '''crypted_password''' a été mal crypté ou corrompu.
 
−
;Invalid credentials
 
−
: Signifie que l'authentification a échoué et que l'utilisateur n'est donc pas reconnu.
 
−
;Invalid or missing signature
 
−
: Signifie que la signature n'est pas présente dans les paramètres reçus par l'API, ou que celle-ci est invalide.
 
−
<br />D'autres remontées d'erreurs sont possibles mais seront contextuelles en fonction de la fonctionnalité souhaitée.
 
−
 
 
−
<!-- Fin de l'article -->
 
−
<br /><br />
 
−
Cet article vous a semblé utile ? <vote />
 
−
<!-- Placez ici la ou les catégories auxquelles se rapporte votre article. Une ligne par catégorie. Ex:
 
−
[[Catégorie:Contribuer]]
 
−
[[Catégorie:Linux]] -->
 
−
[[Catégorie:API]]
 
−
 
 
−
<!-- Gestion SEO. Indiquez les informations manquantes -->
 
−
<br />
 
−
<comments />
 

Version actuelle datée du 22 février 2021 à 16:50

fr:Exemples d'utilisation de l'API he:דוגמאות לשימוש ה-API ro:Exemple de utilizare a API ru:Примеры использования API pl:Przykłady użycia interfejsu API ja:API を使用しての例 ar:أمثلة لاستخدام API zh:使用该 API 的示例 de:Beispiele für die Verwendung der API nl:Voorbeelden van het gebruik van de API it:Esempi di utilizzo dell'API pt:Exemplos de como usar a API es:Ejemplos de uso de la API en:Examples of using the API

  1. REDIRECT Comment_utiliser_l'API_d’Ikoula
Récupérée de « https://fr-wiki.ikoula.com/index.php?title=Exemples_d%27utilisation_de_l%27API&oldid=30152 »