API de registros VoIP - Historial de revisiones

Dbautista en 12:35 2 jul 2021

2021-07-02T12:35:48Z

Lmoreno en 12:23 31 mar 2021

2021-03-31T12:23:11Z

Cbedoya en 12:40 23 jul 2018

2018-07-23T12:40:29Z

Lmoreno en 11:46 11 abr 2017

2017-04-11T11:46:18Z

Cbedoya en 13:16 2 nov 2016

2016-11-02T13:16:45Z

Dbautista en 13:14 26 sep 2016

2016-09-26T13:14:16Z

Dbautista en 13:13 26 sep 2016

2016-09-26T13:13:32Z

Dbautista: Página creada con «{{#seo: |title= API {{PROD_TILDE}}. |titlemode=append |keywords=voip, registros voip, Api, aplicaciones y desarrollo, herramientas web, desarrollo herramientas, API telefon...»

2016-09-26T13:07:31Z

Página creada con «{{#seo: |title= API {{PROD_TILDE}}. |titlemode=append |keywords=voip, registros voip, Api, aplicaciones y desarrollo, herramientas web, desarrollo herramientas, API telefon...»

Página nueva

{{#seo:
|title= API {{PROD_TILDE}}.
|titlemode=append
|keywords=voip, registros voip, Api, aplicaciones y desarrollo, herramientas web, desarrollo herramientas, API telefonia, modulo de telefonia, integracion software, API desarrollador, linea telefonica virtual
|description=API de números: Herramientas de desarrollado para integrar la telefonía en aplicaciones web. Integre su linea telefonica virtual con APIs.
}}

==¿Qué es la API de registros VoIP?==

===Descripción de API===

Este servicio web nos permite listar los registros VoIP de un número virtual, una extensión de centralita o un siptrunk.

==Forma de uso==

===Lista de registros===

Devuelve la lista de registros voip (en XML).

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apiregistrosvoip?usuario_voip=xxxxxxxxx&password_voip=xxxxxxxx

donde:

* 'usuario_voip' es el número de usuario voip (ejemplos: 902009000, 902009009.1234).
* 'password_voip' es la contraseña del usuario voip, establecida en el momento de activarlo.

===Respuesta del servicio API===

El servicio web retorna todas las respuestas en formato [http://es.wikipedia.org/wiki/Extensible_Markup_Language XML]. Todas las respuestas están encerradas en la raíz 'registros', 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" ?>

<registros>
<error>0</error>
</registros>

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" ?>

<registros>
<error>1</error>
<msgerr>Usuario incorrecto.</msgerr>
</registros>

==Ejemplos de uso API==

===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
$usuario = '911010009';
$pass = 'miClaveSecreta';

$curl = curl_init("https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apinumeros?
usuario_voip=${usuario}&password_voip=${pass}"); // LLAMADA DE LA URL
curl_setopt($curl, CURLOPT_HEADER, false); // PARA EVITAR DEVOLUCION DE CABEZERAS 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
?>

----

----

'''Indice'''

[[Página principal]] >> [[Desarrolladores]] >> API de registros VoIP.

← Revisión anterior		Revisión del 12:40 23 jul 2018
Línea 12:		Línea 12:

	Este servicio web nos permite listar los registros VoIP de un número virtual, una extensión de centralita o un siptrunk.		Este servicio web nos permite listar los registros VoIP de un número virtual, una extensión de centralita o un siptrunk.
		+
		+	Si no sabe lo que es una API lea [[que es una api\|¿Qué son las APIs de {{PRODUCTO}}?]]

	==Forma de uso==		==Forma de uso==

@@ Línea 101: / Línea 101: @@
     <ip>83.126.132.62</ip>
     <pais>ES</pais>
-    <ip_privada>172.26.0.201</ip_privada>
+    <ip_privada>172.26.0.101</ip_privada>
     <puerto_cliente>16044</puerto_cliente>
     <puerto_servidor>TCP</puerto_servidor>
@@ Línea 113: / Línea 113: @@
     <ip>185.55.126.82</ip>
     <pais>ES</pais>
-    <ip_privada>192.168.1.201</ip_privada>
+    <ip_privada>192.168.1.101</ip_privada>
     <puerto_cliente>16400</puerto_cliente>
     <puerto_servidor>16080 (m2sip)</puerto_servidor>
@@ Línea 149: / Línea 149: @@
     <ip>82.33.222.153</ip>
     <pais>ES</pais>
-    <ip_privada>172.26.0.201</ip_privada>
+    <ip_privada>172.26.0.101</ip_privada>
     <puerto_cliente>16046</puerto_cliente>
     <puerto_servidor>TCP</puerto_servidor>

@@ Línea 23: / Línea 23: @@
 La URL debe ser:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apiregistrosvoip?usuario_voip=xxxxxxxxx&password_voip=xxxxxxxx</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apiregistrosvoip?usuario_voip=xxxxxxxxx&password_voip=xxxxxxxx
 donde:

@@ Línea 23: / Línea 23: @@
 La URL debe ser:
-https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apiregistrosvoip?usuario_voip=xxxxxxxxx&password_voip=xxxxxxxx
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apiregistrosvoip?usuario_voip=xxxxxxxxx&password_voip=xxxxxxxx</pre>
 donde:
@@ Línea 35: / Línea 35: @@
 Por ejemplo, una respuesta afirmativa sería:
+<pre>
   HTTP/1.1 200 OK
   Date: Mon, 20 Feb 2012 11:43:37 GMT
@@ Línea 49: / Línea 49: @@
     <error>0</error>
   </registros>
+</pre>
 Una respuesta de error sería:
+<pre>
   HTTP/1.1 200 OK
   Date: Mon, 20 Feb 2012 11:43:37 GMT
@@ Línea 66: / Línea 66: @@
     <msgerr>Usuario incorrecto.</msgerr>
   </registros>
+</pre>
 ==Ejemplos de uso API==
@@ Línea 76: / Línea 76: @@
 He aquí un ejemplo en PHP usando cURL, cortesía de tuayudainformatica.com:
+<pre>
   <?php
     $usuario = '911010009';
@@ Línea 89: / Línea 89: @@
     $output = substr($output, 0, 1);            // XML
   ?>
+</pre>
 ===Ejemplo de listado de registros en XML===
+<pre>
   <?xml version="1.0" encoding="UTF-8" ?>
@@ Línea 157: / Línea 157: @@
    </registro>
   </registros>
+</pre>
 ----

@@ Línea 30: / Línea 30: @@
 ===Respuesta del servicio API===
-El servicio web retorna todas las respuestas en formato [http://es.wikipedia.org/wiki/Extensible_Markup_Language XML]. Todas las respuestas están encerradas en la raíz 'registros', 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.
+El servicio web retorna todas las respuestas en formato [https://es.wikipedia.org/wiki/Extensible_Markup_Language XML]. Todas las respuestas están encerradas en la raíz 'registros', 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:

@@ Línea 3: / Línea 3: @@
 |titlemode=append
 |keywords=voip, registros voip, Api, aplicaciones y desarrollo, herramientas web, desarrollo herramientas, API telefonia, modulo de telefonia, integracion software, API desarrollador, linea telefonica virtual
-|description=API de números: Herramientas de desarrollado para integrar la telefonía en aplicaciones web. Integre su linea telefonica virtual con APIs.
+|description=API de  registro VoIP: Herramientas de desarrollo para integrar la telefonía en aplicaciones web. s.
 }}
@@ Línea 17: / Línea 17: @@
 ===Lista de registros===
-Devuelve la lista de registros voip (en XML).
+Devuelve la lista de registros VoIP (en XML).
 La URL debe ser:
@@ Línea 25: / Línea 25: @@
 donde:
-* 'usuario_voip' es el número de usuario voip (ejemplos: 902009000, 902009009.1234).
+* 'usuario_voip' es el número de usuario VoIP  (ejemplos: 902009000, 902009009.1234).
-* 'password_voip' es la contraseña del usuario voip, establecida en el momento de activarlo.
+* 'password_voip' es la contraseña del usuario VoIP , establecida en el momento de activarlo.
 ===Respuesta del servicio API===

@@ Línea 79: / Línea 79: @@
     $pass = 'miClaveSecreta';
-    $curl = curl_init("https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apinumeros?
+    $curl = curl_init("https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apiregistrosvoip?
                        usuario_voip=${usuario}&password_voip=${pass}"); // LLAMADA DE LA URL
     curl_setopt($curl, CURLOPT_HEADER, false);  // PARA EVITAR DEVOLUCION DE CABEZERAS HTTP
@@ Línea 87: / Línea 87: @@
     $output = substr($output, 0, 1);            // XML
   ?>
 ----