SMS
Administrar los mensajes de texto.
- Obtener mensajes - getMessages
- Obtener el mensaje por su identificador único - getMessage
- Insertar o encolar un mensaje - insertMessage
- Inserta o encola un mensaje por dispositivo - insertMessageDevice
Obtener mensajes - getMessages
POST https://api.service24gps.com/api/v1/getMessages
Lista los mensajes SMS por un rango de fechas.
Ver parámetros de solicitud:
Parámetros | Descripción | Ejemplo |
---|---|---|
apikey | Llave de autorización para uso de los Servicios Web. | 25sdsd234234aa93sdsdsd37c70118e72 |
token | Token devuelto por el método getToken. | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
fecha_inicio | Fecha inicio a consultar, si no se manda este parámetro se utiliza la fecha actual. | 2021-11-01 |
fecha_fin | Fecha fin a consultar, si no se manda este parámetro se utiliza la fecha actual. | 2021-11-02 |
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/getMessages' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'fecha_inicio="2021-11-01"' \
--form 'fecha_fin="2021-11-02"'
Respuesta de ejemplo:
{
"status": 200,
"data": [
{
"id": "11",
"fecha_hora": "2021-11-01 14:23:18",
"destinatario": "2226308920",
"mensaje": "Mensaje 01",
"enviado": "1",
"device": "1740301338",
"gateway": "My SMS Gateway"
},
{
"id": "12",
"fecha_hora": "2021-11-02 14:23:10",
"destinatario": "2226489019",
"mensaje": "Mensaje 02",
"enviado": "1",
"device": "323701090018785",
"gateway": "My SMS Gateway"
}
]
}
Ver campos de respuesta:
Campo |
Descripción |
Formato |
---|---|---|
id | Identificador único del mensaje sms dentro de la plataforma. | Entero |
fecha_hora | Fecha hora que se envió el mensaje de sms (GMT Hora de México centro) |
Fecha Hora (Y-m-d H:i:s) |
destinatario | Número telefónico al que se envió el mensaje sms |
Cadena de Texto |
mensaje |
Texto o contenido que se envió |
Cadena de Texto |
enviado |
Bandera para validar si se envió el mensaje: 1 = Enviado, 0 = No enviado |
Valor booleano |
device |
Identificador único del dispositivo (GPS) |
Cadena de Texto |
gateway |
Servicio SMS Gateway que se utilizó para el envío del mensaje. |
Cadena de Texto |
Obtener el mensaje por su identificador único - getMessage
POST https://api.service24gps.com/api/v1/getMessage
Obtiene el mensaje SMS por su Id.
Ver parámetros de solicitud:
Parámetros | Descripción | Ejemplo |
---|---|---|
apikey | Llave de autorización para uso de los Servicios Web. | 25sdsd234234aa93sdsdsd37c70118e72 |
token | Token devuelto por el método getToken. | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
id | Identificador único del mensaje sms. | 11 |
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/getMessage' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'id="11"'
Respuesta de ejemplo:
{
"status": 200,
"data": {
"id": "11",
"fecha_hora": "2021-11-01 14:23:18",
"destinatario": "2226308920",
"mensaje": "Mensaje 01",
"enviado": "1",
"device": "1740301338",
"gateway": "My SMS Gateway"
}
}
Ver campos de respuesta:
Campo |
Descripción |
Formato |
---|---|---|
id | Identificador único del mensaje sms dentro de la plataforma. | Entero |
fecha_hora | Fecha hora que se envió el mensaje de sms (GMT Hora de México centro) |
Fecha Hora (Y-m-d H:i:s) |
destinatario | Número telefónico al que se envió el mensaje sms |
Cadena de Texto |
mensaje |
Texto o contenido que se envió |
Cadena de Texto |
enviado |
Bandera para validar si se envió el mensaje: 1 = Enviado, 0 = No enviado |
Valor booleano |
device |
Identificador único del dispositivo (GPS) |
Cadena de Texto |
gateway |
Servicio SMS Gateway que se utilizó para el envío del mensaje. |
Cadena de Texto |
Insertar o encolar un mensaje - insertMessage
POST https://api.service24gps.com/api/v1/insertMessage
Registra o encola un nuevo mensaje SMS.
Ver parámetros de solicitud:
Parámetros | Descripción | Ejemplo |
---|---|---|
apikey | Llave de autorización para uso de los Servicios Web. | 25sdsd234234aa93sdsdsd37c70118e72 |
token | Token devuelto por el método getToken. | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
to | Número telefónico del destinatario | 2226308920 |
message | Texto a mandar o encolar. | Hola mundo! |
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/insertMessage' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'to="2226308920"' \
--form 'message="Hola mundo!"'
Respuesta de ejemplo:
{
"status": 200,
"data": {
"id": "11"
}
}
Ver campos de respuesta:
Campo |
Descripción |
Formato |
---|---|---|
id | Identificador único del mensaje sms dentro de la plataforma. | Entero |
Inserta o encola un mensaje por dispositivo - insertMessageDevice
POST https://api.service24gps.com/api/v1/insertMessageDevice
Registra o encola un nuevo mensaje SMS a través de un dispositivo.
Ver parámetros de solicitud:
Parámetros | Descripción | Ejemplo |
---|---|---|
apikey | Llave de autorización para uso de los Servicios Web. | 25sdsd234234aa93sdsdsd37c70118e72 |
token | Token devuelto por el método getToken. | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
device | Identificador único del dispositivo (GPS) | 1743201963 |
message | Texto a mandar o encolar. | Hola mundo! |
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/insertMessageDevice' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'device="1743201963"' \
--form 'message="Hola mundo!"'
Respuesta de ejemplo:
{
"status": 200,
"data": {
"id": "11"
}
}
Ver campos de respuesta:
Campo |
Descripción |
Formato |
---|---|---|
id | Identificador único del mensaje sms dentro de la plataforma. | Entero |