CHEAPVOIP: WEB API per controllare il credito residuo
|
ISTRUZIONI PER TESTARE L'APPLICAZIONE
ATTENZIONE: il metodo seguente
è riportato solo come
esempio per uso di test.
E' fortemente sconsigliata la messa in produzione di uno script contenente username e password scritti in chiaro *. E' invece consigliato l'uso del metodo "AVANZATO" riportato successivamente. * non criptato Esempio di utilizzo tramite chiamata diretta HTTP POST:
<html>
<body>
<form action="http://www.cheapnet.it/areautenti/voip/sms/credito-residuo-api.php" method="POST">
<input type="hidden" name="username" value="utente@cheapnet.it">
<input type="hidden" name="password" value="secret">
<input type="submit" name="Submit" value="Invia">
</form>
</body>
</html>
Per poter utilizzare lo script occorre:
Per conoscere il credito residuo dell'account CheapVoIP ricaricabile viene fornita una piccola libreria, in linguaggio PHP, che può essere utilizzata in sostituzione dell'esempio precedente. I requisiti necessari per utilizzare questa libreria sono:
La configurazione di username e password dell'utente Cheapnet abilitato a CheapVoIP Ricaricabile deve essere effettuata solo nel file di libreria "cheapvoip-credito-residuo.inc.php". Di seguito vengono riportati due esempi chiarificatori e la libreria. richiesta-credito-residuo.php - Esempio Codice PHP per leggere il credito residuo del proprio account ricaricabile
<html>
<head>
<title>Cheapnet » CheapVoIP, web api per il controllo del credito residuo</title>
</head>
<body>
<div align="center">
<h1>Controllo del credito residuo</h1>
<!-- form per la richiesta -->
<!-- si imposta l'action con il nome ed il percorso del file (risposta-credito-residuo.php riportato nella pagina) che invoca la WEB API-->
<form method="post" name="form" action="risposta-credito-residuo.php">
<!-- si interroga la pagina per conoscere il credito residuo-->
<input name="Submit" type="submit" value="Invia"></td>
</tr>
</table>
</form>
</div>
</body>
</html>
risposta-credito-residuo.php - Esempio completo di pagina HTML che include la libreria e gestice la risposta
<html>
<head>
<title>Esito richiesta credito residuo</title>
</head>
<body>
<div align="center"><?php
//si include la libreria
require("cheapvoip-credito-residuo.inc.php");
$ret=leggiCreditoResiduo();
// Visualizzo l'esito dell'invio
$autorizzato=$ret[0]["autorizzato"];
$evento=$ret[0]["evento"];
$profilo=$ret[0]["profilo"];
$esito=$ret[1]["esito"];
$risposta=$ret[1]["risposta"];
$credito_residuo=$ret[1]["credito_residuo"];
if ($autorizzato == true) {
echo USERNAME . ": " . $evento ."<br />Profilo: " . $profilo . " <br />";
} else {
echo "Utente " . USERNAME . " non autorizzato";
}
if ($esito == true) {
echo $risposta . "<br />Il credito residuo è di: " . $credito_residuo . " euro iva esclusa<br>";
} else {
echo $risposta;
}
?>
</div>
</body>
</html>
cheapvoip-credito-residuo.inc.php - Libreria per la lettura del credito residuo
<?php
/* MODIFICARE SOLO QUESTI DUE CAMPI */
//username di Cheapnet (che sia abilitato all'utilizzo di CheapVoIP e che abbia un profilo Home o Plus purché ricaricabile)
define("USERNAME","<utente@cheapnet.it>");
//password di Cheapnet
define("PASSWORD","<password>");
//url della web api
define("URLAPI","http://www.cheapnet.it/areautenti/voip/sms/credito-residuo-api.php");
function leggiCreditoResiduo() {
$ch = curl_init(URLAPI);
//chiamata alla funzione curl di php -con metodo POST- per invocare la WEB API
curl_setopt($ch, CURLOPT_POST, TRUE);
$params = "username=" . USERNAME . "&password=". PASSWORD;
//passaggio parametri tramite curl
curl_setopt($ch,CURLOPT_POSTFIELDS,$params);
ob_start();
curl_exec($ch);
//catturo i risultati
$xmlResponse =ob_get_contents();
ob_end_clean();
curl_close($ch);
//decodifico il risultato XML
$response = xmlrpc_decode($xmlResponse,"iso-8859-1");
return $response;
}
?>
Tutti i file sopra riportati sono riuniti in un unico file di archivio (.zip) e sono disponibili per il download. |