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": "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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |