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

Ok Leer más

Documentación

GET /api/sms/ID/

Consulta el estado del envío de un sms a un teléfono

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:
Petición: 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 desfase 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

Parámetros

Se espera el siguiente parámetro en la url

Nombre
Descripción
ID
(Obligatorio)
ID del envío, el valor fue devuelto al hacer la petición de envío

Respuesta

Se devuelve, en formato json, un array con los siguientes parametros

Nombre
Descripción
estado
Estado del envío
mensajes
Numero total de mensajes de los que se compone el sms
creditos
Numero de créditos consumidos por el envío. En caso de no haberse enviado el mensaje puede devolver 0 o null indistintamente. Para envíos anteriores al 25/08/2017 este dato no esta disponible y se devolverá null

Los estados que se pueden recibir y su significado son los siguientes:

Ejemplo

Peticion:

GET http://www.smsup.es/api/sms/160/ HTTP/1.1
Host: www.smsup.es
Firma: 923jrdslf923sdlkfjlijweo39284327:bbaecdd96b9df9fdd31ee4130e0b485a93490213
SMS-DATE: 2013-11-04T17:51:21+01:00

Respuesta:

{"estado":"Entregado a destino", "mensajes":"1", "creditos":"1.00"}