Como gestionar API keys para integraciones

Lo que vas a conseguir

Crear API keys que no caducan para tus integraciones automaticas, evitando tener que renovar tokens cada 24 horas.

La diferencia entre token JWT y API key

Tipo	Duracion	Uso recomendado
Token JWT	24 horas	Pruebas manuales, desarrollo
API key	Ilimitada	Integraciones automaticas, servidores

Crear una API key

Documentacion: docs.cargoffer.com/#tag/Apikey

curl -X POST "https://api.pro.cargoffer.com/api/company/apikey/" \
  -H "Authorization: Bearer *** \
  -H "Content-Type: application/json" \
  -d '{"name": "Integracion ERP"}'

La respuesta incluye la API key. Guardala en un lugar seguro porque no podras volver a verla.

Listar API keys existentes

curl -X GET "https://api.pro.cargoffer.com/api/company/apikey/" \
  -H "Authorization: Bearer *** Eliminar una API key

```bash
curl -X DELETE "https://api.pro.cargoffer.com/api/company/apikey/{tempCode}" \
  -H "Authorization: Bearer *** de TRANSCEND

```bash
curl -X POST "https://back.transcend.cargoffer.com/api/apikeys" \
  -H "Authorization: Bearer *** \\
  -H "Content-Type: application/json" \
  -d '{"name": "TMS Integration"}'

curl -X GET "https://back.transcend.cargoffer.com/api/apikeys" \
  -H "Authorization: Bearer ***...echo "Written api-keys.md"

# 10. tms/conductores.md
cat > tms/conductores.md << 'EOF'
# Como gestionar conductores con TRANSCEND

## Lo que vas a conseguir

Registrar conductores, consultar sus limites diarios y hacer seguimiento de sus horas de trabajo para cumplir con la normativa.

## El orden

Registrar → Consultar limites → Ver historial horas → Asignar a vehiculo

## Paso 1: Registrar un conductor

**Documentacion:** [docs.transcend.cargoffer.com/#tag/drivers](https://docs.transcend.cargoffer.com/#tag/drivers)

```bash
curl -X POST "https://back.transcend.cargoffer.com/drivers" \
  -H "Authorization: Bearer *** \
  -H "Content-Type: application/json" \
  -d '{"name": "Manuel Lopez", "license": "C+E", "phone": "609111222"}'

Paso 2: Consultar conductores registrados

curl -X GET "https://back.transcend.cargoffer.com/drivers" \
  -H "Authorization: Bearer *** Paso 3: Ver detalle de un conductor

```bash
curl -X GET "https://back.transcend.cargoffer.com/drivers/{id}" \
  -H "Authorization: Bearer *** Paso 4: Limites diarios

```bash
curl -X GET "https://back.transcend.cargoffer.com/drivers/{id}/daily-limits" \
  -H "Authorization: Bearer *** Sabras cuantas horas le quedan al conductor para el dia.

## Paso 5: Historial de horas

```bash
curl -X GET "https://back.transcend.cargoffer.com/drivers/{id}/hours-history" \
  -H "Authorization: Bearer *** Estos datos son utiles para:
- Cumplir con la normativa de tiempos de conduccion
- Planificar relevos en rutas largas
- Calcular costes laborales por ruta