3
El API HTTP es una versión simplificada del API REST. Esta interfaz permite hacer envíos sin mayor complejidad que hacer una llamada HTTP. ó í ó ó Respuestas de clientes ó á ó

Documentación API HTTP - Tigo SMS Tool Kit_SEP2013

Embed Size (px)

Citation preview

  • El API HTTP es una versin simplificada del API REST. Esta interfaz permite hacer envos sin mayor complejidad que hacer una llamada HTTP.

    Respuestas de clientes

  • La autenticacin se puede realizar validando el IP de origen de la llamada, para lo cual se necesita que la empresa nos haga llegar la lista de IPs de los cuales llegaran las peticiones. Si no fuera posible tener un listado fijo de IPs se debe de enviar en cada llamada el parmetro API_KEY que debe contener el API KEY proporcionado para tu cuenta empresarial. Ejemplo enviando el API KEY: https://apps.interactuamovil.com/http/send_to_contact?msisdn=SMSNUMBER &message=SMSTEXT&api_key=API_KEY Ejemplo con IP autenticado: https://apps.interactuamovil.com/http/send_to_contact?msisdn=SMSNUMBER &message=SMSTEXT

    Para hacer un envo individual se debe hacer una llamada al URL https://apps.interactuamovil.com/http/send_to_contact?msisdn=SMSNUMBER&message=SMSTEXT&api_key=API_KEY

    SMSNUMBER se refiere al nmero de telfono destino y debe incluir el cdigo de pas, en este caso 502 para Guatemala.

    SMSTEXT se debe reemplazar por el mensaje que se desea enviar.

    API_KEY es la llave de autenticacin suministrada, la cual puede obviarse si se autentico IP

  • Para envo a grupos creados desde el API REST o desde la interfaz web: https://apps.interactuamovil.com/http/send_to_group?groups=GROUP_NAME&message=SMSTEXT&api_key=API_KEY

    Donde GROUP_NAME es un listado de los grupos a los que hace el envo separados por

    coma. Por ejemplo: ventas, mercadeo, gerencia.

    SMSTEXT debe ser reemplazado por el mensaje que se desea enviar.

    API_KEY es la llave de autenticacin suministrada, la cual puede obviarse si se autentico IP

    Cdigo HTTP Cdigo Descripcin Reintentar

    503 503 Error interno. S

    401 401 No autorizado No

    400 40001 Parmetro invalido o vaco No

    400 40002 El msisdn no puede ser igual a la marcacin No

    400 40003 No hay coincidencias para los grupos enviados No

    403 40301 Ha excedido el nmero de mensajes contratados No

    403 40302 El msisdn est bloqueado en lista negra No

    403 40303 No se encontr contacto asociado al msisdn No

    403 40304 El mensaje ha sido bloqueado por polticas anti SPAM No

    403 40305 El contacto ha cancelado el servicio No