API para Enviar SMS. Petición y Respuesta

Podrás usar este método para enviar SMS del PlaySMS desde una plataforma/aplicación diferente al propio servidor PlaySMS. Tus clientes podrán usar sus propias aplicaciones para enviar SMS usando la cuenta de PlaySMS que tú les suministres. Las peticiones son tipo HTTP que pueden ser enviadas por método POST o GET. 

Saber Más sobre API de PlaySMS

pv

u h to msg

type unicode from footer nofooter format

El parámetro to es precisamente el destino del SMS, que puede ser un sólo número de teléfono único (en formato respectivo) o números múltiples usando las etiquetas @nombredeusuario ó #grupodecódigo (los cuales están especificados en el PlaySMS), o combinación de ellos separados por coma. Conocer los demás parámetros aquí.

 Conocer los Parámetros

Ejemplo de Uso

Ejemplo de URL. Puede ser enviado por POST (p.e. en formulario) o GET (p.e. en la barra de direcciones del navegador).

http://156.145.178.208/playsms/index.php?app=ws&op=pv&u=yonttyguz&h=eff998961454ea568ecdb2839434d4fd7ac18&to=5731872677705&msg=Test_api&nofooter=1

Explicación del anterior ejemplo. Se envía un SMS (cuya operación/método/función se denomina pv) a través del servidor de PlaySMS instalado en el directorio http://156.145.178.208/playsms, al número destino 573187267705 (que es un celular de Colombia), cuyo mensaje es Test_api, haciendo uso de la cuenta de usuario/subusuario yonttyguz cuyo token de webservice es eff998961454ea568ecdb2839434d4fd7ac18 (que se puede ver en las Preferencias del usuario/subusuario). Se indica no enviar pie de página con nofooter=1.

Un ejemplo de respuesta en el caso de éxito del envío es en formato JSON: 

{"data":[{"status":"OK","error":"0","smslog_id":"30","queue":"afb5f34575e30ec4efe4471cf5d1bee4","to":"573187267705"}],"error_string":null}

Cuando se produce un error en el PlaySMS se devolverá uno de los códigos de retorno también en formato JSON.

Más Sobre los Parámetros

Más Sobre los Códigos de Retorno

Fuente. Artículo traducido y con muy ligeras modificaciones de: https://github.com/antonraharja/playSMS/blob/master/documents/development/WEBSERVICES.md 

Sobre el Autor

Author: Pipe Peña

Soy un loco enamorado de la vida. Licenciado en Ciencias Sociales y Humanas, amante de la informática y la astrofísica. Me gusta crear e investigar proyectos que enriquezcan la construcción y desarrollo del conocimiento individual y colectivo. Me encantan los videojuegos, el cine, la química, matemáticas, la física cuántica y la música, en donde actualmente soy compositor. Me baso en la idea que toma Baruch Spinoza sobre Dios.