Conductores

• Listar conductores - driverGetAll
• Crear conductor - createDriver
• Actualizar conductor - updateDriver
• Eliminar conductor - deleteDriver
• Listar conductores con grupo y vehículo - driverInfoGetAll
• Listar catálogo de grupos de conductores - driverGetGroups
• Listar conductor por licencia - getDriverByIdCard

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": "MTIzNDU2"
        },
        {
            "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": "MTIzNDU2"
        },
        {
            "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": "MTIz"
        }
    ]
}

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 codificada en base64.	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