Conductores

Listar conductores - driverGetAll

POST https://api.service24gps.com/api/v1/driverGetAll

Obtiene la lista de todos los conductores que pertenecen al cliente.

Ver parámetros de solicitud:
Parámetros Descripción Ejemplo
apikey (Requerido) Llave de autorización para uso de los Servicios Web. 25sdsd234234aa93sdsdsd37c70118e72
token (Requerido) Token devuelto por el método getToken. wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
licencia (Opcional) Número de Licencia. 123456

Nota: Si requiere solo la información de un conductor en especifico, debe mandar en la solicitud el parámetro licencia con el número de licencia que tiene asignado el conductor.

Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/driverGetAll' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'
Respuesta de ejemplo:
{
    "status": 200,
    "data": [
          {
            "id": "43530",
            "numero": "0987654321",
            "alias": "test_new_driver",
            "nombre": "Test Nombre",
            "apellido": "New Driver",
            "identificador": "TEST0987654NWD",
            "fecha_alta": "2022-02-25",
            "telefono": "1234567890",
            "cedula": "FSGBSTR001",
            "licencia": "78979TEST123",
            "vigencia": "2022-05-14",
            "direccion": "test de domicilio de conductor test",
            "email": "test@test.com",
            "idvehiculo": "37922",
            "idgrupo": "0",
            "nombregrupo": "",
            "observaciones": "creacion de conductor test1",
            "usuario": "driver_test1",
            "password": "cGFzczEyMw=="
        },
        {
            "id": "43531",
            "numero": "0987654321",
            "alias": "test_new_driver2",
            "nombre": "Test Nombre 2",
            "apellido": "New Driver 2",
            "identificador": "TEST89956156",
            "fecha_alta": "2022-02-25",
            "telefono": "1234567890",
            "cedula": "FSGBSTR002",
            "licencia": "78979TEST1232",
            "vigencia": "2022-05-15",
            "direccion": "test de domicilio de conductor test2",
            "email": "test2@test.com",
            "idvehiculo": "37923",
            "idgrupo": "0",
            "nombregrupo": "",
            "observaciones": "creacion de conductor test2",
            "usuario": "driver_test2",
            "password": "g7z8zGFzcyM78="
        },
        {
            "id": "43532",
            "numero": "098765432133",
            "alias": "test_new_driver3",
            "nombre": "Test Nombre 3",
            "apellido": "New Driver 3",
            "identificador": "TEST895662563",
            "fecha_alta": "2022-02-25",
            "telefono": "1234567890",
            "cedula": "FSGBSTR003",
            "licencia": "78979TEST1233",
            "vigencia": "2022-06-15",
            "direccion": "test de domicilio de conductor test3",
            "email": "test3@test.com",
            "idvehiculo": "37924",
            "idgrupo": "0",
            "nombregrupo": "",
            "observaciones": "creacion de conductor test3",
            "usuario": "driver_test3",
            "password": "c789epczEyM78="
        }
    ]
}
Ver campos de respuesta:
Campo

Descripción

Formato
id

Identificador único asignado al conductor.

Entero
numero

Código interno para identificar al conductor.

Cadena de texto
alias

Nombre alterno para identificar al conductor.

Cadena de texto

nombre

Nombre del conductor.

Cadena de texto

apellido

Apellido del conductor.

Cadena de texto

identificador

Código de iButton o RFID asignado al conductor.

Cadena de texto

fecha_alta

Fecha en que se creó el conductor en el sistema.

Date (aaaa-mm-dd)
telefono

Identificador único de la ruta en el sistema.

Cadena de texto

cedula

Número de cédula.

Cadena de texto

licencia

Número de licencia.

Cadena de texto

vigencia

Fecha en que expira la licencia del conductor.

Date (aaaa-mm-dd)

direccion

Ubicación del domicilio del conductor.

Cadena de texto

email

E-mail de contacto del conductor.

Cadena de texto

idvehiculo

Id del vehículo asignado al conductor.

Entero

idgrupo

Id del grupo al que pertenece el conductor.

Entero

nombregrupo

Nombre del grupo al que pertenece el conductor.

Cadena de texto

observaciones

Observaciones realizadas por el operador.

Cadena de texto

usuario

Usuario del conductor.

Cadena de texto

password

Contraseña del conductor.

Cadena de texto

Crear conductor - createDriver

POST https://api.service24gps.com/api/v1/createDriver

Permite realizar el alta de un conductor al sistema. * Campos requeridos.

Todos los parámetros deben enviarse en la solicitud, los marcados con * es obligatorio que tengan un valor.

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==
nombre

Nombre del conductor. *

Test Nombre 3

apellido

Apellido del conductor.

New Driver 3

alias

Nombre alterno para identificar al conductor.

test_new_driver3

identificador

Código de iButton o RFID asignado al conductor.

TEST895662563

numero

Código interno para identificar al conductor.

0987654321

telefono

Número de teléfono del conductor. *

1234567890

cedula

Número de cédula.

FSGBSTR003

licencia

Número de licencia. *

78979TEST1233

vigencia

Fecha en que expira la licencia del conductor. *

2022-06-15

direccion

Ubicación del domicilio del conductor. *

test de domicilio de conductor test3

email

E-mail de contacto del conductor. *

test3@test.com

idvehiculo

Id del vehículo asignado al conductor. *

37924

observaciones

Observaciones realizadas por el operador.

Observación de conductor test3

idgrupo

Identificador del grupo

3

user

Usuario del conductor. (Opcional)

driver_test3

password

Contraseña del conductor. (Opcional)

pass123

Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/createDriver' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'nombre="Test Nombre 3"' \
--form 'apellido="New Driver 3"' \
--form 'alias="test_new_driver3"' \
--form 'identificador="TEST895662563"' \
--form 'numero="0987654321"' \
--form 'telefono="1234567890"' \
--form 'cedula="FSGBSTR003"' \
--form 'licencia="78979TEST1233"' \
--form 'vigencia="2022-06-15"' \
--form 'direccion="test de domicilio de conductor test3"' \
--form 'email="test3@test.com"' \
--form 'idvehiculo="37924"' \
--form 'idgrupo="3"' \
--form 'observaciones="Observación de conductor test3"' \
--form 'user="driver_test3"' \
--form 'password="pass123"'
Respuesta de ejemplo:
{
    "status": 200,
    "data": {
        "id": "710900",
        "msg": "Se creó el conductor"
    }
}

Nota: Si el usuario a crear ya existe, se mostrará el siguiente mensaje.

Respuesta de ejemplo:
{
    "status": 200,
    "data": {
        "code": 30700,
        "message": "No se pudo crear el usuario driver_test"
    }
}

Actualizar conductor - updateDriver

POST https://api.service24gps.com/api/v1/updateDriver

Permite realizar la modificación de la información de un conductor. * Campos requeridos.

Todos los parámetros deben enviarse en la solicitud, los marcados con * es obligatorio que tengan un valor.

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==
idConductor

Id del conductor *

123456
nombre

Nombre del conductor. *

Update Test Nombre 3

apellido

Apellido del conductor.

New Driver 3

alias

Nombre alterno para identificar al conductor.

test_new_driver3

identificador

Código de iButton o RFID asignado al conductor.

TEST895662563

numero

Código interno para identificar al conductor.

0987654321

telefono

Número de teléfono del conductor. *

1234567890

cedula

Número de cédula.

FSGBSTR003

licencia

Número de licencia. *

78979TEST1233

vigencia

Fecha en que expira la licencia del conductor. *

2022-06-15

direccion

Ubicación del domicilio del conductor. *

test de domicilio de conductor test3

email

E-mail de contacto del conductor. *

test3@test.com

idvehiculo

Id del vehículo asignado al conductor.

37924

observaciones

Observaciones realizadas por el operador.

Observación de conductor test3

idgrupo

Identificador del grupo

0

user

Usuario del conductor. (Opcional)

driver_test3

password

Contraseña del conductor. (Opcional)

pass123

Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/updateDriver' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'idConductor="123456"' \
--form 'nombre="Update Test Nombre 3"' \
--form 'apellido="New Driver 3"' \
--form 'alias="test_new_driver3"' \
--form 'identificador="TEST895662563"' \
--form 'numero="0987654321"' \
--form 'telefono="1234567890"' \
--form 'cedula="FSGBSTR003"' \
--form 'licencia="78979TEST1233"' \
--form 'vigencia="2022-06-15"' \
--form 'direccion="test de domicilio de conductor test3"' \
--form 'email="test3@test.com"' \
--form 'idvehiculo="37924"' \
--form 'observaciones="Observación de conductor test3"' \
--form 'idgrupo="0"' \
--form 'user="driver_test3"' \
--form 'password="pass123"'
Respuesta de ejemplo:
{
    "status": 200,
    "data": {
        "id": "123456",
        "msg": "Se actualizó el conductor"
    }
}

Nota: El usuario a actualizar debe pertenecer al cliente, de lo contrario no se realiza la actualización y se muestra el siguiente mensaje.

Respuesta de ejemplo:
{
    "status": 200,
    "data": {
        "code": 30700,
        "message": "El usuario driver_test3 ya existe"
    }
}

Eliminar conductor - deleteDriver

POST https://api.service24gps.com/api/v1/deleteDriver

Este método permite eliminar un conductor especifico.

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==
idConductor

Identificador único del conductor en el sistema.

138225
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/deleteDriver' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'idConductor="138225"'
Respuesta de ejemplo:
{
    "status": 200,
    "data": ""
}

Nota: Si en la respuesta de la solicitud aparece "status": 30700 es un error al obtener los datos.

Respuesta de ejemplo:
{
    "status": 30700,
    "data": ""
}

Listar conductores con grupo y vehículo - driverInfoGetAll

POST https://api.service24gps.com/api/v1/driverInfoGetAll

Obtiene la lista de todos los conductores del cliente con la relación vehículo y grupo conductor. 

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==
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/driverInfoGetAll' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'
Respuesta de ejemplo:
{
    "status": 200,
    "data": [
		{
            "id": "43530",
            "numero": "0987654321",
            "alias": "test_new_driver",
            "nombre": "Test Nombre",
            "apellido": "New Driver",
            "identificador": "TEST0987654NWD",
            "fecha_alta": "2022-02-25",
            "telefono": "1234567890",
            "cedula": "FSGBSTR001",
            "licencia": "78979TEST123",
            "vigencia": "2022-05-14",
            "direccion": "test de domicilio de conductor test",
            "email": "test@test.com",
            "idvehiculo": "37922",
            "idgrupo": "10",
            "observaciones": "creacion de conductor test",
            "idgrupo_conductor": "10",
            "nombrevehiculo": "Ford GS",
            "patente": "GSI-78955",
            "nombregrupo": "Test1"
        },
        {
            "id": "43531",
            "numero": "0987654321",
            "alias": "test_new_driver2",
            "nombre": "Test Nombre 2",
            "apellido": "New Driver 2",
            "identificador": "TEST89956156",
            "fecha_alta": "2022-02-25",
            "telefono": "1234567890",
            "cedula": "FSGBSTR002",
            "licencia": "78979TEST1232",
            "vigencia": "2022-05-15",
            "direccion": "test de domicilio de conductor test2",
            "email": "test2@test.com",
            "idvehiculo": "37923",
            "idgrupo": "11",
            "observaciones": "creacion de conductor test2",
            "idgrupo_conductor": "11",
            "nombrevehiculo": "KIA IZURIETA",
            "patente": "GSI-7206",
            "nombregrupo": "Test2"
        }
    ]
}
Ver campos de respuesta:
Campo

Descripción

Formato
id

Identificador único asignado al conductor.

Entero
numero

Código interno para identificar al conductor.

Cadena de texto
alias

Nombre alterno para identificar al conductor.

Cadena de texto

nombre

Nombre del conductor.

Cadena de texto

apellido

Apellido del conductor.

Cadena de texto

identificador

Código de iButton o RFID asignado al conductor.

Cadena de texto

fecha_alta

Fecha en que se creó el conductor en el sistema.

Date (aaaa-mm-dd)
telefono

Identificador único de la ruta en el sistema.

Cadena de texto

cedula

Número de cédula.

Cadena de texto

licencia

Número de licencia.

Cadena de texto

vigencia

Fecha en que expira la licencia del conductor.

Date (aaaa-mm-dd)

direccion

Ubicación del domicilio del conductor.

Cadena de texto

email

E-mail de contacto del conductor.

Cadena de texto

idvehiculo

Id del vehículo asignado al conductor.

Entero

idgrupo

Id del grupo al que pertenece el conductor.

Entero

observaciones

Observaciones realizadas por el operador.

Cadena de texto

idgrupo_conductor

Identificador del grupo que pertenece el conductor.

Entero

nombrevehiculo

Nombre del vehículo. 

Cadena de texto

patente

Patente del vehículo. 

Cadena de texto

nombregrupo

Nombre del grupo al que pertenece el conductor.

Cadena de texto

Listar catálogo de grupos de conductores - driverGetGroups

POST https://api.service24gps.com/api/v1/driverGetGroups

Obtiene el catálogo de los grupos de conductores del cliente.

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==
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/driverGetGroups' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'
Respuesta de ejemplo:
{
    "status": 200,
    "data": {
        "143": "Conductores RedGPS",
      	"160": "Conductores Centrales",
      	"172": "Conductores Estacion Oriente",
        "173": "Conductores Estacion Poniente"
    }
}

Listar conductor por licencia - getDriverByIdCard

POST https://api.service24gps.com/api/v1/getDriverByIdCard

Obtiene la información del conductor por el parámetro licencia.

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==
licencia  Número de licencia. 78979TEST123
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/getDriverByIdCard' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'\
--form 'licencia="78979TEST123"'\
Respuesta de ejemplo:

{
    "status": 200,
    "data": [
          {
            "id": "43530",
            "numero": "0987654321",
            "alias": "test_new_driver",
            "nombre": "Test Nombre",
            "apellido": "New Driver",
            "identificador": "TEST0987654NWD",
            "fecha_alta": "2022-02-25",
            "telefono": "1234567890",
            "cedula": "FSGBSTR001",
            "licencia": "78979TEST123",
            "vigencia": "2022-05-14",
            "direccion": "test de domicilio de conductor test",
            "email": "test@test.com",
            "idvehiculo": "37922",
            "idgrupo": "0",
            "nombregrupo": "",
            "observaciones": "creacion de conductor test1",
            "usuario": "driver_test1",
            "password": "cGFzczEyMw=="
        }
    ]
}
Ver campos de respuesta:
Campo

Descripción

Formato
id

Identificador único asignado al conductor.

Entero
numero

Código interno para identificar al conductor.

Cadena de texto
alias

Nombre alterno para identificar al conductor.

Cadena de texto

nombre

Nombre del conductor.

Cadena de texto

apellido

Apellido del conductor.

Cadena de texto

identificador

Código de iButton o RFID asignado al conductor.

Cadena de texto

fecha_alta

Fecha en que se creó el conductor en el sistema.

Date (aaaa-mm-dd)
telefono

Identificador único de la ruta en el sistema.

Cadena de texto

cedula

Número de cédula.

Cadena de texto

licencia

Número de licencia.

Cadena de texto

vigencia

Fecha en que expira la licencia del conductor.

Date (aaaa-mm-dd)

direccion

Ubicación del domicilio del conductor.

Cadena de texto

email

E-mail de contacto del conductor.

Cadena de texto

idvehiculo

Id del vehículo asignado al conductor.

Entero

idgrupo

Id del grupo al que pertenece el conductor.

Entero

nombregrupo

Nombre del grupo al que pertenece el conductor.

Cadena de texto

observaciones

Observaciones realizadas por el operador.

Cadena de texto

usuario

Usuario del conductor.

Cadena de texto

password

Contraseña del conductor.

Cadena de texto