De Open movilforum wiki

[editar] Introducción

El servicio Copiagenda te permite guardar de forma automática los contactos de la agenda almacenados en tu tarjeta SIM y/o en tu terminal.

Para poder usar este servicio hay que ser cliente movistar España y tener una tarjeta SIM de 128Kb. Si además quieres almacenar los contactos de la agenda del teléfono, éste tiene que ser compatible con la tecnología SyncMl.

[editar] Operaciones

Aunque todas las peticiones se realizan a través del protocolo HTTPS, se han representado siguiendo el formato de peticiones HTTP.

[editar] Login

Es la primera petición que tenemos que realizar. Consiste en un Login por HTTPS similar al de otros servicios de movistar utilizando nuestro nombre de usuario y nuestra clave (que podemos obtener enviando un mensaje corto al 770).

POST /cp/ps/Main/login/Agenda HTTP/1.1
Host: copiagenda.movistar.es
Content-Type: application/x-www-form-urlencoded

TM_ACTION=LOGIN&TM_LOGIN=6xxxxxxxx&TM_PASSWORD=xxxxxx

Como respuesta a esta primera petición se nos redireccionará a la URL https://copiagenda.movistar.es/cp/ps/Main/login/Verificacion?d=movistar.es y se nos asignarán las Cookies s y skf, que deberemos utilizar en las peticiones posteriores.

GET /cp/ps/Main/login/Verificacion?d=movistar.es HTTP/1.1
Host: copiagenda.movistar.es
Cookie: s=xxxxxxxx, skf=xxxxxxxx

En la respuesta a esta petición deberemos buscar nuestra clave codificada para re-autenticarnos con ella:

POST /cp/ps/Main/login/Authenticate HTTP/1.1
Host: copiagenda.movistar.es
Content-type: application/x-www-form-urlencoded
Referer: https://copiagenda.movistar.es/cp/ps/Main/login/Verificacion?d=movistar.es
Cookie: s=xxxxxxxx, skf=xxxxxxxx

password=pwdCodificado&u=6xxxxxxxx&d=movistar.es

En esta nueva respuesta deberemos buscar un identificador de sesión (token) que necesitaremos para poder recuperar los contactos de Copiagenda.

[editar] Recuperación de contactos

Deberemos realizar la petición incluyendo los datos que hemos ido recopilando en las anteriores (cookie y token). En concreto, el token debe unirse a nuestro número de teléfono como se muestra a continuación.

POST "/cp/ps/PSPab/preferences/ExportContacts?d=movistar.es&c=yes&u=6xxxxxxxxtoken
Host: copiagenda.movistar.es
Referer: https://copiagenda.movistar.es/cp/ps/Main/login/Verificacion?d=movistar.es
Content-type: application/x-www-form-urlencoded
Cookie: s=xxxxxxxx, skf=xxxxxxxx

fileFormat=TEXT&charset=8859_1&delimiter=TAB

Los números se reciben en un fichero en formato CSV (separado por tabuladores) que puede ser utilizado posteriormente.

[editar] Búsqueda de contacto

El API incluye la posibilidad de buscar un determinado contacto a partir del nombre que le hayamos asignado en nuestra agenda.