Generar acceso a la app móvil para un conductor

POST

/teams/{teamId}/drivers/{driverId}/access

const url = 'https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/drivers/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/access';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

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/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/drivers/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/access \
  --header 'Authorization: Bearer <token>'

Un admin/owner genera acceso a la app móvil: crea el usuario en el pool de Cognito dedicado a conductores con un username autogenerado a partir del nombre (ej. “Juan Pérez” → “juan.perez”, con sufijo numérico si ya existe en el pool, que es compartido entre equipos) y una contraseña temporal. El conductor típicamente no tiene correo, así que las credenciales se devuelven en la respuesta para que el admin se las entregue manualmente (ej. WhatsApp) — no se vuelven a mostrar. Falla con 409 si el conductor ya tiene una cuenta ACTIVE.

Authorizations

cognitoAuth

Parameters

Path Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

driverId

required

string format: uuid

ID del conductor (UUID)

Responses

201

Acceso generado

application/json

object

message

string

driverId

string format: uuid

username

string

temporaryPassword

string

appAccessStatus

Estado de la cuenta del conductor en el pool de Cognito de la app móvil

string

Allowed values: NONE INVITED ACTIVE DISABLED

Example

{
  "message": "Acceso generado. Copia el usuario y la contraseña temporal y entrégalos al conductor manualmente (ej. WhatsApp) — no se vuelven a mostrar.",
  "driverId": "770e8400-e29b-41d4-a716-446655440002",
  "username": "juan.perez",
  "temporaryPassword": "Xk9#mQ2p",
  "appAccessStatus": "INVITED"
}

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