Saltar a: navegación, buscar

API de precios

¿Qué es API de para Teléfonos precios?

Descripción

Este servicio web nos permite ver los diferentes precios de llamar o enviar un SMS a un número en particular utilizando los servicios de Mi Oficina Web.

Si no sabe lo que es una API lea ¿Qué son las APIs de Mi Oficina Web?

Forma de uso API de precios

Lista de precios

Devuelve los diferentes precios (en XML).

La URL debe ser:

https://scgi.duocom.es/cgi-bin/oficinaweb/apiprecios?telefono=xxxxxxxxx

donde:

  • 'telefono' es el número de teléfono para el cual quiere consultar los precios.


Respuesta del servicio

El servicio web retorna todas las respuestas en formato XML. Todas las respuestas están encerradas en la raíz 'precios', y contiene siempre un campo 'error' que será 0 si el comando o petición enviado al servidor se ejecutó con éxito, o 1 si hubo algún error, en cuyo caso habrá también un campo 'msgerr' que explica dicho error.

Por ejemplo, una respuesta afirmativa sería:

HTTP/1.1 200 OK
 Date: Mon, 20 Feb 2012 11:43:37 GMT
 Server: Apache
 Keep-Alive: timeout=15, max=100
 Connection: Keep-Alive
 Transfer-Encoding: chunked
 Content-Type: text/xml
 
 <?xml version="1.0" encoding="UTF-8" ?>
 
 <precios>
   <error>0</error>
 </precios>

Una respuesta de error sería:

 HTTP/1.1 200 OK
 Date: Mon, 20 Feb 2012 11:43:37 GMT
 Server: Apache
 Keep-Alive: timeout=15, max=100
 Connection: Keep-Alive
 Transfer-Encoding: chunked
 Content-Type: text/xml
 
 <?xml version="1.0" encoding="UTF-8" ?>
 
 <precios>
   <error>1</error>
   <msgerr>Cuenta incorrecta.</msgerr>
 </precios>

Ejemplos API de precios

Ejemplo de llamada al servicio web en PHP + CURL

Tenga presente que, aunque la aplicación web es accesible mediante una URL, no debe poner nunca enlaces a esta aplicación directamente en el código fuente de sus páginas web, ya que sus visitantes podrían descubrir datos sensibles como su número de usuario y su contraseña simplemente mirando el código HTML.

La aplicación web debe ser llamada siempre desde el servidor, usando para ello alguna de las librerías que permite llamadas a servicios HTTPS.

He aquí un ejemplo en PHP usando cURL, cortesía de tuayudainformatica.com:

 <?php
   $telefono = '666111666';
 
   $curl = curl_init("https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apiprecios?
                      telefono=${telefono}"); // LLAMADA DE LA URL
   curl_setopt($curl, CURLOPT_HEADER, false);  // PARA EVITAR DEVOLUCION DE CABECERAS HTTP
   curl_setopt($curl, CURLOPT_TIMEOUT, 5);     // TIEMPO DE ESPERA   
   $output = curl_exec($curl);                 // EJECUTAMOS LA LLAMADA
   curl_close($curl);
   $output = substr($output, 0, 1);            // XML
 ?>

Ejemplo de listado de precios en XML

 <?xml version="1.0" encoding="UTF-8" ?>
 
 <precios>
 <error>0</error>
 <telefono>0034666111666</telefono>
 <iva>18</iva>
 <igic>7</igic>
 <acceso_local>
   <precio>0.07</precio>
   <precio_con_iva>0.09</precio_con_iva>
   <precio_con_igic>0.08</precio_con_igic>
 </acceso_local>
 <voip>
   <precio>0.07</precio>
   <precio_con_iva>0.09</precio_con_iva>
   <precio_con_igic>0.08</precio_con_igic>
 </voip>
 <p107009>
   <precio>0.09</precio>
   <precio_con_iva>0.11</precio_con_iva>
   <precio_con_igic>0.10</precio_con_igic>
 </p107009>
 <sms>
   <precio>0.08</precio>
   <precio_con_iva>0.10</precio_con_iva>
   <precio_con_igic>0.09</precio_con_igic>
 </sms>
 </precios>


Indice

Página principal >> Desarrolladores >> API de precios.