Consulta de Ubicaciones en Lote

Un api partner puede consultar las ubicaciones de viajes en lote para un grupo de viajes utilizando sus ids.

Consultar ubicaciones de viajes

Endpoint:

URL: baseURL/V2/corporate-api-partner/bulk-trip-location

Método: POST

Autenticación: Bearer Token requerido en el header

Body payload (ejemplo):

{
  "trip_ids": [
    "507f1f77bcf86cd799439011",
    "507f1f77bcf86cd799439012"
  ]
}

Campo	Descripción	Tipo de dato	Validaciones	Ejemplo
trip_ids	Array de identificadores de viaje	Array de strings	- No puede estar vacío - Cada ID debe ser un MongoID válido	["507f1f77bcf86cd799439011"]

Respuesta típica:

{
    "success": true,
    "code": "00",
    "msg": "ok",
    "data": {
        "trips": [
            {
                "_id": "507f1f77bcf86cd799439011",
                "providerLocation": [
                    10.45678,
                    -66.87654
                ]
            }
        ]
    }
}

Campo	Descripción	Tipo de dato
success	Indica si la petición fue exitosa	Boolean
code	Código de respuesta	String
msg	Mensaje descriptivo de la respuesta	String
data.trips	Array con la información de los viajes consultados	Array
data.trips[].\_id	Identificador del viaje	String
data.trips[].providerLocation	Coordenadas [latitud, longitud] de la ubicación actual	Array de números

TIP

Las coordenadas se devuelven en formato [latitud, longitud] con precisión de 5 decimales

Posibles códigos de error

Código	Descripción
400	Request inválido - Array de IDs vacío o mal formado
401	No autorizado - Token inválido o expirado