Skip to main content

​
Estado del storage

GET /api/v1/storage/status
Verifica si el almacenamiento S3 esta disponible. 
curl -X GET https://sandbox.cucu.bo/api/v1/storage/status \
  -H "X-API-Key: sk_test_MuLfItnPAScdhgrOsYn6Y4ur_gdMfCSMXtLciK9P8S8"

{
  "success": true,
  "data": {
    "s3Enabled": true,
    "timestamp": "2026-02-11T12:00:00"
  }
}

​
Test de conectividad

POST /api/v1/storage/test
Ejecuta un test completo de S3: upload, verificacion de existencia, descarga y comparacion de contenido. 
{
  "success": true,
  "data": {
    "upload": true,
    "exists": true,
    "download": true,
    "contentMatch": true
  }
}

​
Subir logo de empresa

POST /api/v1/storage/brand/logo?companyId={uuid}
Sube el logo de la empresa que aparece en los PDFs de las facturas.

​
Headers

​
X-API-Key
string
required
Tu API Key.
​
Content-Type
string
required
image/png

​
Query Parameters

​
companyId
string
required
UUID de la empresa.

​
Body

El body debe ser el archivo PNG binario del logo. 
curl -X POST "https://sandbox.cucu.bo/api/v1/storage/brand/logo?companyId=660e8400-e29b-41d4-a716-446655440002" \
  -H "X-API-Key: sk_test_MuLfItnPAScdhgrOsYn6Y4ur_gdMfCSMXtLciK9P8S8" \
  -H "Content-Type: image/png" \
  --data-binary @logo.png

{
  "success": true,
  "data": {
    "s3Key": "brand/logos/660e8400.../logo.png",
    "cdnUrl": "https://cdn.cucu.bo/brand/logos/660e8400.../logo.png",
    "size": 45678
  }
}
Recomendamos logos PNG con fondo transparente, tamaño maximo 500KB, y dimensiones minimas de 200x200px.