Como empezar con la API de Cargoffer

Lo que vas a conseguir

Obtener tus credenciales de API, configurar tu empresa y estar listo para hacer tu primera peticion.

El orden de las operaciones

Registrarse → Verificar email → Login → Configurar empresa → Obtener API key

Sin completar un paso no puedes pasar al siguiente. Te explicamos por que.

---

Paso 1: Crear tu cuenta

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

curl -X POST "https://api.pro.cargoffer.com/api/company/auth/register" \
  -H "Content-Type: application/json" \
  -d '{"email": "tu@empresa.com", "password": "tu_password", "companyName": "Tu Empresa SL"}'

Te llegara un email de confirmacion. El registro crea tu empresa en el sistema pero aun no puedes operar.

---

Paso 2: Verificar el email

curl -X POST "https://api.pro.cargoffer.com/api/company/auth/activate" \
  -H "Content-Type: application/json" \
  -d '{"token": "el_token_del_email"}'

Por que: Necesitamos confirmar que el email es tuyo. Es un requisito legal y de seguridad.

---

Paso 3: Iniciar sesion y obtener token

curl -X POST "https://api.pro.cargoffer.com/api/company/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email": "tu@empresa.com", "password": "tu_password"}'

La respuesta incluye un token JWT. Este token caduca a las 24 horas y lo usaras en todas las peticiones siguientes en el header Authorization: Bearer {token}.

---

Paso 4: Configurar los datos de tu empresa

curl -X PUT "https://api.pro.cargoffer.com/api/company/company_data/" \
  -H "Authorization: Bearer *** \
  -H "Content-Type: application/json" \
  -d '{"name": "Tu Empresa SL", "cif": "B12345678", "address": "C/ Mayor 1, Madrid", "phone": "+34910000000"}'

Por que estos datos: Son necesarios para las facturas y los contratos. El CIF aparece en todos los documentos legales.

---

Paso 5: Crear una API key (opcional para integraciones)

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

Las API keys no caducan (a diferencia del token JWT) y son ideales para integraciones automaticas.

---

Siguiente paso

Ya tienes todo listo. Ahora puedes publicar tu primera carga.