API para el envío SMS

(API) Realice envios de SMS a traves de nuestro Servicio Web

Guía del Servicio Web (API)

Puede descargar una completa guía en PDF sobre cómo usar el Servicio Web (API), Descargar Guía de Uso

Introducción al Servicio Web o API

Puede encontrar el Servicio Web en la dirección: http://www.afilnet.com/ws/, aquí podrá encontrar el listado de métodos para poder interactuar con el servicio de Afilnet, para conectar el Servicio Web con sus aplicaciones debe usar la conexion con el archivo XML: http://www.afilnet.com/ws/index.php?wsdl

¿Cómo Usar el Servicio Web?

Para poder usar el Servicio Web o API en su Software realizando una conexión con el mismo, dependiendo del lenguaje de programación necesitará hacer uso de un conjunto de clases o módulos, por ello le ofrecemos un listado de manuales o guías que les ayudará en la integración:

PHP
http://blog.osusnet.com/2008/08/06/consumiendo-webservices-soap-desde-php/
http://developer.swekee.com/2008/09/03/consumir-un-servicio-web-en-php-utilizando-nusoap/

JAVA / JSP
http://ccia.ei.uvigo.es/docencia/SCS/practicas0809/practica-6/index.html
http://www.youtube.com/watch?v=X0iqDwdw-IA
http://www.youtube.com/watch?v=fqStUwVlUdk

.NET (C# y Visual Basic .net)
http://www.desarrolloweb.com/articulos/1745.php
http://ccia.ei.uvigo.es/docencia/SCS/practicas0809/practica-6/index.html
http://www.15seconds.com/Issue/010530.htm (English)

RUBY ON RAILS
http://www.ibm.com/developerworks/opensource/library/os-ws-rubyrails/index.html (English)

Funciones del Servicio Web o API

Las funciones del servicio web son las siguientes:

string GetVersion() - Devuelve la versión del servicio web

int CrearGrupo(string email, string clave, string nombre, Columnas columnas) - Función que crea un grupo, para ello se pasan por parametros el email y clave del usuario, el nombre del grupo y Columnas del grupo, y devuelve el identificador del grupo que se acaba de crear.

Stats Estadisticas(string email, string clave) - Esta función devuelve estadisticas sobre los envios realizados, se pasan por parametros los datos de acceso del usuario y devuelve una estructura "Stats" formada por los siguientes campos

struct Stats {
string numsms;
string envios;
}

numsms - Número de SMS Enviados
envios - Número de envíos Realizados

int EliminarGrupo(string email, string clave, int grupo) - Esta función recibe por parametros los datos del usuario y el numero de grupo, y devuelve 1 en caso de que se realice de forma correcta, -1 si el login es incorrecto o 0 en caso de q.

int ActualizaGrupo(string email, string clave, int grupo, string nombre, Columnas columnas) - Función que actualiza un grupo, para ello se pasan por parametros el email y clave del usuario, el numero y nuevo nombre del grupo y las Columnas del grupo, y devuelve el identificador del grupo que se ha modificado.

int AddGrupo(string email, string clave, int grupo, Columnas columnas, Columnas datos) - Función que añade un registro al grupo dado, para ello se pasan por parametros los datos de acceso del usuario, el numero del grupo, una estructura Columnas con las columnas del Grupo y otra tabla Columnas con los datos del Grupo.

int Login(string email, string clave) - Función que comprueba los datos de acceso, en caso de ser correctos, devuelve el identificador del usuario, en caso de no ser correctos devuelve 0.

string EnviaSMS(string email, string clave, string remitente, string pais, string destino, string sms) - Función que realiza el envio de un SMS único, para ello recibe por parametros los datos de acceso del usuario, el nombre o nombre del remitente, el codigo de pais de destino y el mensaje de sms.

Los códigos de país destino compatibles son:

España = 34

En caso de envio correcto devuelve OK, en caso contrario devuelve el error

string EnviarSMSMasivo(string email, string clave, string remitente, string pais, int grupo, string sms, int inicio) - Función para la realización de envios de forma masiva, para ello recibe por parametros los datos de acceso del usuario, el remitente, el codigo del pais, el identificador del grupo, el mensaje sms, y el numero del primer registro donde se envia (los envios se realizarán de 10 en 10, teniendo por tanto en cuenta que el primer registro es 0).

En caso de envio correcto devuelve OK, en caso contrario devuelve el error

int Creditos(string email, string clave) - Función que devuelve el numero de creditos restante del usuario, recibe por parametros los datos del usuario.

string GetRecargaURL(string email, string clave) - Devuelve la dirección de recarga para el usuario determinado. Recibe por parametros los datos del usuario.

Grupo[] GetGrupos(string email, string clave) - Devuelve un array de estructuras de tipo Grupo. Recibe por parametros los datos del usuario.

struct Grupo {
int id; // Identificador del Grupo
string grupo; // Nombre del Grupo
int usuarios; // Numero de Usuarios
}