Esta web utiliza 'cookies' propias y de terceros para ofrecerte una mejor experiencia y servicio

Ok Leer más

Documentación

GET /api/peticion/REF/

Obtiene el resultado dado de una petición a POST /api/sms/ identificada por la referencia dada

Cabeceras

El sistema espera las siguientes cabeceras:

Nombre
Descripción
Firma
(Obligatorio)
Esta cabecera se usa para autentificar al usuario. Su valor está formado por el id de cliente API, dos puntos y la firma que identifica la petición.
Esta firma es el hash sha1, usando el método HMAC, de los parámetros que identifican la petición, usando la clave secreta de usuario.
Los parámetros que identifican la petición son:
VERBO+ruta sin host+Fecha ISO 8601+POST si procede.
Ej:
Peticion: POST/api/sms/2013-10-10T19:19:21+02:00{“texto”:”Esto es una prueba de la api”,”telefonos”:[“67812736812″,”61253213″],”fecha”:”NOW”}
Cabecera: Firma: 923jrdslf923sdlkfjlijweo39284327: 3d7af8726a31fb73de269cc08352b323a73880d8
Sms-Date
(Obligatorio)
Su valor es la fecha que se uso para generar la firma en la cabecera Firma. Es la fecha y hora en el momento de hacer la petición, en formato ISO 8601. Se admite un desface de +/-10 minutos con el servidor. Si la fecha no es correcta la petición da error.
Ej: 2013-10-10T19:19:21+02:00

Parametros

Se espera el siguiente parámetro en la url

Nombre
Descripción
REF
(Obligatorio)
Referencia dada al hacer una petición de envío

Respuesta

Se devuelve, en formato json, un array que contiene una entrada por cada envío que se anotó, en la petición de referencia la indicada.

Nombre
Descripción
telefono
Teléfono al que se enviara el sms, tal y como se indico en la petición
id
Id otorgado al sms. Este id es el se utiliza para conocer el estado del envío

Ejemplo

Peticion:

GET http://www.smsup.es/api/peticion/dsafj392487jsf/ HTTP/1.1
Host: www.smsup.es
Firma: 923jrdslf923sdlkfjlijweo39284327:e7b673b4d52f24f7d473dfb1d52db0cda8d62c28
SMS-DATE: 2013-11-04T18:18:21+01:00

Respuesta:

[{"telefono":"67812736812","id":"160"},{"telefono":"61253213","id":"161"}]