Webservices HTTP API PlaySMS para Obtener una Lista de Contactos
Obtener una Lista de Contactos
Nota. Podrás usar este método para conocer la lista de contactos del PlaySMS desde una plataforma/aplicación diferente al propio servidor PlaySMS. Tus clientes podrán usar sus propias aplicaciones para conocer la lista de contactos 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
Obtener la lista de contactos por nombre, móvil o correo electrónico:
Parámetros | Nombre o descripción |
---|---|
Operation |
|
Mandatory |
|
Optional |
|
Returns | Lista de contactos similares o iguales a kwd o En JSON. Códigos de retorno. Dé click aquí |
Más Sobre los Códigos de Retorno
Obtener una Lista de Contactos Grupales
Obtener lista de contactos grupales por nombre o código:
Parámetros | Nombre o descripción |
---|---|
Operation |
|
Mandatory |
|
Optional |
|
Returns | Lista de grupos de contacto similares o iguales a kwd o En JSON. Códigos de retorno. Dé click aquí |
Lista de Contactos en la Agenda
Ejemplo de URL del servicio web:
http://
156.45.78.208/playsms/index.php?app=ws&u=anton&h=482ac0069592c647289e52dfef88be68&op=get_contact&kwd=anton
Explicación del anterior ejemplo:
Se accedió a los servicios web del PlaySMS en x.com con la operación op get_contact por un usuario que usó el nombre de usuario u webservices token h con la palabra clave kwd anton y el formato de salida esperado está en formato JSON.
Cuando tenga éxito, playSMS devolverá el mensaje de estado OK en formato JSON:
{"status":"OK","error":"0","data":[{"pid":"13674","gpid":"2","p_desc":"Anton Raharja","p_num":"08901230659","email":"","group_name":"Test Group","code":"TESTGROUP"}],"multi":true}
Cuando se produce un error en PlaySMS se devolverá uno de los códigos de retorno, también en formato JSON.
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