# 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ámetrosDescripciónEjemplo
apikey**(Requerido)** Llave de autorización para uso de los Servicios Web.25sdsd234234aa93sdsdsd37c70118e72
token**(Requerido)** Token devuelto por el método [**getToken**](https://docs.redgps.com/books/webservice/page/metodo-de-autenticacion-gettoken-7ef).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: ```shell curl --location --request POST 'https://api.service24gps.com/api/v1/driverGetAll' \ --form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \ --form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' ``` ##### Respuesta de ejemplo: ```JSON { "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:
CampoDescripción Formato
idIdentificador único asignado al conductor. Entero
numeroCódigo interno para identificar al conductor. Cadena de texto
aliasNombre 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)
telefonoIdentificador ú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ámetrosDescripciónEjemplo
apikeyLlave de autorización para uso de los Servicios Web. \*25sdsd234234aa93sdsdsd37c70118e72
tokenToken devuelto por el método getToken. \*wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
nombreNombre 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: ```shell 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: ```JSON { "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: ```JSON { "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ámetrosDescripciónEjemplo
apikeyLlave de autorización para uso de los Servicios Web. \*25sdsd234234aa93sdsdsd37c70118e72
tokenToken devuelto por el método getToken. \*wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
idConductor
Id del conductor \* 123456
nombreNombre 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: ```shell 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: ```JSON { "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: ```JSON { "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ámetrosDescripciónEjemplo
apikeyLlave de autorización para uso de los Servicios Web.25sdsd234234aa93sdsdsd37c70118e72
tokenToken devuelto por el método getToken.wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
idConductorIdentificador único del conductor en el sistema. 138225
##### Solicitud de ejemplo: ```shell curl --location --request POST 'https://api.service24gps.com/api/v1/deleteDriver' \ --form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \ --form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \ --form 'idConductor="138225"' ``` ##### Respuesta de ejemplo: ```JSON { "status": 200, "data": "" } ```

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

##### Respuesta de ejemplo: ```JSON { "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ámetrosDescripciónEjemplo
apikeyLlave de autorización para uso de los Servicios Web.25sdsd234234aa93sdsdsd37c70118e72
tokenToken devuelto por el método getToken.wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
##### Solicitud de ejemplo: ```shell curl --location --request POST 'https://api.service24gps.com/api/v1/driverInfoGetAll' \ --form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \ --form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' ``` ##### Respuesta de ejemplo: ```JSON { "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:
CampoDescripción Formato
idIdentificador único asignado al conductor. Entero
numeroCódigo interno para identificar al conductor. Cadena de texto
aliasNombre 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)
telefonoIdentificador ú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ámetrosDescripciónEjemplo
apikeyLlave de autorización para uso de los Servicios Web.25sdsd234234aa93sdsdsd37c70118e72
tokenToken devuelto por el método getToken.wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
##### Solicitud de ejemplo: ```shell curl --location --request POST 'https://api.service24gps.com/api/v1/driverGetGroups' \ --form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \ --form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' ``` ##### Respuesta de ejemplo: ```JSON { "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ámetrosDescripciónEjemplo
apikeyLlave de autorización para uso de los Servicios Web.25sdsd234234aa93sdsdsd37c70118e72
tokenToken devuelto por el método getToken.wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
licencia Número de licencia. 78979TEST123
##### Solicitud de ejemplo: ```shell curl --location --request POST 'https://api.service24gps.com/api/v1/getDriverByIdCard' \ --form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \ --form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'\ --form 'licencia="78979TEST123"'\ ``` ##### Respuesta de ejemplo: ```JSON { "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:
CampoDescripción Formato
idIdentificador único asignado al conductor. Entero
numeroCódigo interno para identificar al conductor. Cadena de texto
aliasNombre 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)
telefonoIdentificador ú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