El conductor confirma el inicio de su viaje

POST

/trips/{tripId}/start

const url = 'https://api.dev.lade.com.mx/trips/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/start';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"lat":25.6866,"lng":-100.3161}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.dev.lade.com.mx/trips/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/start \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "lat": 25.6866, "lng": -100.3161 }'

Transiciona el viaje de NO_INICIADO a EN_PROCESO. Solo el conductor asignado al viaje (trip.driverId) puede iniciarlo. Reusa la misma lógica de transición que PATCH /trips/{tripId}/status (sincroniza ocupación de conductor/vehículo, registra el evento en la línea de tiempo y la auditoría).

Authorizations

cognitoDriversAuth

Parameters

Path Parameters

tripId

required

string format: uuid

ID del viaje (UUID)

Request Body

application/json

Coordenadas opcionales del punto de inicio

object

lat

number

>= -90 <= 90

lng

number

>= -180 <= 180

Example

{
  "lat": 25.6866,
  "lng": -100.3161
}

Responses

200

Viaje iniciado

application/json

object

message

string

tripId

string format: uuid

previousStatus

Estado del viaje

string

Allowed values: NO_INICIADO EN_PROCESO FINALIZADO_A_TIEMPO FINALIZADO_CON_RETRASO CANCELADO

newStatus

Estado del viaje

string

Allowed values: NO_INICIADO EN_PROCESO FINALIZADO_A_TIEMPO FINALIZADO_CON_RETRASO CANCELADO

Example

{
  "message": "Trip status updated successfully",
  "tripId": "880e8400-e29b-41d4-a716-446655440003",
  "previousStatus": "NO_INICIADO",
  "newStatus": "EN_PROCESO"
}

400

Solicitud inválida

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Validation failed",
  "field": "email",
  "message": "Invalid email format"
}

403

Sin permisos

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}

404

Recurso no encontrado

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Not found",
  "message": "Resource not found"
}

409

Conflicto con recurso existente

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Conflict",
  "message": "Resource already exists"
}